MongoDB MCP Server installieren und konfigurieren

In der sich ständig weiterentwickelnden Landschaft der Softwareentwicklung ist die Integration von Künstlicher Intelligenz kein Zukunftskonzept mehr, sondern eine gegenwärtige Realität. KI-gestützte Tools werden für Entwickler schnell unverzichtbar, da sie Arbeitsabläufe optimieren und die Produktivität steigern. Diesen Trend erkennend, hat MongoDB ein bahnbrechendes Tool eingeführt, das die Lücke zwischen Ihrer Datenbank und KI schließt: den MongoDB Model Context Protocol (MCP) Server. Dieses Tutorial bietet eine umfassende Schritt-für-Schritt-Anleitung zur Installation und Konfiguration des MongoDB MCP Servers, die es Ihnen ermöglicht, das volle Potenzial der KI in Ihrer Entwicklungsumgebung zu nutzen.

💡

Möchten Sie ein großartiges API-Test-Tool, das wunderschöne API-Dokumentation generiert?

Möchten Sie eine integrierte All-in-One-Plattform, auf der Ihr Entwicklerteam mit maximaler Produktivität zusammenarbeiten kann?

Apidog erfüllt all Ihre Anforderungen und ersetzt Postman zu einem viel günstigeren Preis!

button

Was ist der MongoDB MCP Server?

Der MongoDB MCP Server ist ein leistungsstarkes neues Tool, das entwickelt wurde, um Ihre MongoDB-Bereitstellungen mit einer Vielzahl von KI-gestützten Clients zu verbinden, die das Model Context Protocol (MCP) unterstützen. Egal, ob Sie MongoDB Atlas, die vollständig verwaltete Cloud-Datenbank, oder eine selbst gehostete Community- oder Enterprise Advanced-Edition verwenden, der MCP Server ermöglicht eine nahtlose Interaktion mit Ihren Daten mithilfe natürlicher Sprache. Das bedeutet, Sie können eine breite Palette von Datenbankoperationen durchführen, von einfachen Datenabfragen bis hin zu komplexen administrativen Aufgaben, alles über intuitive, konversationelle Befehle innerhalb Ihrer bevorzugten KI-Entwicklungstools.

Das MCP ist ein offener Standard, der ursprünglich von Anthropic eingeführt wurde und schnell an Bedeutung gewinnt, da er eine standardisierte Kommunikationsschicht zwischen KI-Agenten und verschiedenen Datensystemen schafft. Durch die Implementierung dieses Protokolls stellt MongoDB sicher, dass seine Benutzer an vorderster Front der KI-gesteuerten Entwicklung bleiben können. Der MCP Server ermöglicht einen Zwei-Wege-Kommunikationskanal, der es Ihnen nicht nur erlaubt, Ihre Daten abzufragen, sondern auch Ihren Large Language Models (LLMs) die aktuellsten und kontextuell relevantesten Informationen aus Ihrer Datenbank zur Verfügung zu stellen. Dies ist ein entscheidender Vorteil für Aufgaben wie Datenexploration, Datenbankadministration und die Generierung von kontextbezogenem Code.

Der MongoDB MCP Server unterstützt ein wachsendes Ökosystem von MCP-Clients, darunter:

Windsurf: Ein KI-nativer Code-Editor, bei dem der MCP-Server sofort verfügbar ist.
Cursor: Ein beliebter KI-gestützter Code-Editor.
GitHub Copilot in Visual Studio Code: Bringt die Leistungsfähigkeit Ihrer Datenbank in die beliebteste IDE der Welt.
Anthropic's Claude: Interagieren Sie direkt aus der Claude Desktop-Anwendung mit Ihrer Datenbank.

Lassen Sie uns beginnen!

Voraussetzungen

Bevor wir uns in den Installationsprozess vertiefen, gibt es ein paar Voraussetzungen, die Sie erfüllen müssen:

Node.js und npx: Der MongoDB MCP Server ist eine Node.js-Anwendung und wird typischerweise mit npx, dem Node.js-Paket-Runner, installiert und ausgeführt. Sie benötigen Node.js Version 18 oder höher auf Ihrem System. Sie können Ihre Node.js-Version überprüfen, indem Sie ein Terminal oder eine Eingabeaufforderung öffnen und node -v ausführen.
MongoDB Verbindungszeichenfolge oder Atlas API-Anmeldedaten: Um eine Verbindung zu Ihrer Datenbank herzustellen, benötigt der MCP Server entweder eine Standard-MongoDB-Verbindungszeichenfolge oder API-Anmeldedaten für Ihr MongoDB Atlas-Konto.
Verbindungszeichenfolge: Dies ist das Standard-URI-Format zum Herstellen einer Verbindung zu einer MongoDB-Instanz. Es enthält Benutzername, Passwort, Host, Port und Datenbankname.
Atlas API-Anmeldedaten: Wenn Sie MongoDB Atlas verwenden, können Sie ein Dienstkonto mit den erforderlichen Berechtigungen erstellen und die generierte API Client ID und das Client Secret zur Authentifizierung verwenden. Diese Methode ist erforderlich, um die Atlas-spezifischen Tools zu verwenden.
Ein MCP-Client: Sie benötigen einen der unterstützten MCP-Clients, wie z. B. Cursor, Claude Desktop oder Visual Studio Code mit der GitHub Copilot-Erweiterung.
Docker (Optional): Wenn Sie den MCP Server lieber in einer containerisierten Umgebung ausführen möchten, benötigen Sie Docker und Docker Compose. Dies ist besonders nützlich für lokale Sandbox-Tests und um eine lokale Node.js-Installation zu vermeiden.

Installation und Konfiguration

Der Installations- und Konfigurationsprozess für den MongoDB MCP Server variiert leicht je nach verwendetem MCP-Client. Der Kern des Prozesses besteht darin, eine JSON-Konfiguration zur Einstellungsdatei Ihres Clients hinzuzufügen, die ihm mitteilt, wie der MCP-Server gestartet und kommuniziert werden soll.

Der Hauptbefehl zum Ausführen des Servers lautet npx -y mongodb-mcp-server. Das Flag -y bestätigt automatisch die Installation des Pakets, falls es noch nicht vorhanden ist.

Einrichtung in Cursor

Cursor ist ein KI-basierter Code-Editor, der schnell an Popularität gewinnt. So richten Sie den MongoDB MCP Server in Cursor ein:

Öffnen Sie die Cursor-Einstellungen: Starten Sie Cursor und klicken Sie auf das Zahnradsymbol in der oberen rechten Ecke des Fensters, um die Einstellungen zu öffnen.
Navigieren Sie zum MCP-Bereich: Klicken Sie im Einstellungsbereich auf der linken Seite auf "MCP".
Fügen Sie einen neuen globalen MCP-Server hinzu: Klicken Sie auf die Schaltfläche "Add new global MCP server". Dadurch wird eine JSON-Konfigurationsdatei geöffnet.
Geben Sie die Konfiguration ein: Kopieren Sie die folgende JSON-Konfiguration und fügen Sie sie in die Datei ein. Sie müssen diese mit Ihren Verbindungsdetails anpassen.

JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "environments": [
      {
        "name": "ATLAS_API_CLIENT_ID",
        "value": "your-atlas-api-client-id"
      },
      {
        "name": "ATLAS_API_CLIENT_SECRET",
        "value": "your-atlas-api-client-secret"
      }
    ]
  }
}

Wenn Sie eine Verbindungszeichenfolge anstelle von Atlas API-Anmeldedaten verwenden, sieht Ihre Konfiguration wie folgt aus:JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

Speichern Sie die Konfiguration: Speichern Sie die Datei. Cursor kann nun Ihren neuen MongoDB MCP Server verwenden.

Nachdem der Server konfiguriert ist, können Sie nun innerhalb von Cursor mithilfe natürlicher Sprache mit Ihrer Datenbank interagieren. Wenn Sie Ihre Atlas API-Anmeldedaten verwendet haben, haben Sie Zugriff auf eine umfangreiche Sammlung von Atlas-spezifischen Tools, mit denen Sie kostenlose Cluster erstellen, Zugriffslisten verwalten, Datenbankbenutzer erstellen und vieles mehr tun können. Wenn Sie eine Verbindungszeichenfolge verwendet haben, haben Sie Zugriff auf Tools zur Datenbankverwaltung, wie z. B. Auflisten von Datenbanken und Sammlungen, Verwalten von Indizes und Durchführen von CRUD-Operationen (Create, Read, Update, Delete).

Einrichtung in Claude Desktop

Wenn Sie ein Benutzer von Anthropic's Claude sind, können Sie den MongoDB MCP Server direkt in die Claude Desktop-Anwendung integrieren.

Öffnen Sie die Konfigurationsdatei: Starten Sie die Claude Desktop-Anwendung und navigieren Sie dann zu Settings > Developer > Edit Config. Dadurch wird die Datei claude_desktop_config.json in Ihrem Standard-Texteditor geöffnet. Der Speicherort dieser Datei ist typischerweise:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Fügen Sie die MCP Server-Konfiguration hinzu: Fügen Sie die folgende Konfiguration zum mcpServers-Objekt in der JSON-Datei hinzu.

JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--connectionString",
        "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/test"
      ]
    }
  }
}

Stellen Sie sicher, dass Sie die Platzhalter-Verbindungszeichenfolge durch Ihre tatsächliche Verbindungszeichenfolge ersetzen.

Starten Sie Claude Desktop neu: Schließen Sie die Claude Desktop-Anwendung und starten Sie sie neu.
Überprüfen Sie den Server: Klicken Sie in Claude Desktop auf das Hammer-Symbol. Der MongoDB MCP Server sollte nun als verfügbares Tool aufgeführt sein.

Einrichtung in Visual Studio Code mit GitHub Copilot

Für die Millionen von Entwicklern, die Visual Studio Code verwenden, kann der MongoDB MCP Server mit GitHub Copilot integriert werden, um die Interaktion mit der Datenbank in natürlicher Sprache in Ihre bevorzugte IDE zu bringen.

Öffnen Sie die Befehlspalette: Öffnen Sie VS Code und drücken Sie Strg+Umschalt+P (oder Cmd+Umschalt+P unter macOS), um die Befehlspalette zu öffnen.
Fügen Sie einen neuen MCP-Server hinzu: Geben Sie "mcp" in die Befehlspalette ein und wählen Sie "MCP: Add Servers".
Wählen Sie Command Standard I/O: Wählen Sie "Command Standard I/O" als Servertyp.
Geben Sie den Befehl ein: Geben Sie den Befehl npx -y mongodb-mcp-server ein und geben Sie Ihrem Server einen Namen, z. B. "mongodb".
Konfigurieren Sie in settings.json: Dadurch wird Ihre Datei settings.json geöffnet. Hier können Sie Ihre Argumente und Umgebungsvariablen hinzufügen. Zum Beispiel, um eine Verbindungszeichenfolge zu verwenden:

JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

Oder, um Atlas API-Anmeldedaten zu verwenden:JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "options": {
      "env": {
        "ATLAS_API_CLIENT_ID": "your-atlas-api-client-id",
        "ATLAS_API_CLIENT_SECRET": "your-atlas-api-client-secret"
      }
    }
  }
}

Starten Sie den Server: Sie können den Server starten, indem Sie auf die Schaltfläche "Start" klicken, die über dem Servernamen in Ihrer Datei settings.json erscheint, oder indem Sie die Befehlspalette öffnen, nach "MCP: List Servers" suchen, Ihren Server auswählen und dann "Start Server" auswählen.

Sobald der Server läuft, können Sie den GitHub Copilot Agentenmodus verwenden, um mit Ihrer MongoDB Atlas-Umgebung zu interagieren. Sie können ihn bitten, Ihre Projekte aufzulisten, neue Cluster zu erstellen, Benutzer zu verwalten und vieles mehr, alles direkt aus VS Code.

Erweiterte Konfiguration

Der MongoDB MCP Server bietet verschiedene erweiterte Konfigurationsoptionen, um sein Verhalten an Ihre spezifischen Bedürfnisse anzupassen.

Schreibgeschützter Modus

Für zusätzliche Sicherheit, insbesondere beim Verbinden mit Produktionsdatenbanken, können Sie den Server im schreibgeschützten Modus ausführen. Dies verhindert jegliche Schreiboperationen, wie das Erstellen, Aktualisieren oder Löschen von Dokumenten. Sie können den schreibgeschützten Modus über ein Befehlszeilenargument aktivieren:

npx mongodb-mcp-server --readOnly

Oder durch Setzen einer Umgebungsvariablen:

export MDB_MCP_READ_ONLY=true

Deaktivieren bestimmter Tools

Sie können bestimmte Tools deaktivieren, um die Fähigkeiten des Servers einzuschränken. Dies ist nützlich für die Sicherheit oder zur Vereinfachung der verfügbaren Befehle. Sie können Tools über das Befehlszeilenargument --disabledTools deaktivieren, gefolgt von einer durch Leerzeichen getrennten Liste von Toolnamen.

npx mongodb-mcp-server --disabledTools create update delete atlas collectionSchema

Alternativ können Sie die Umgebungsvariable MDB_MCP_DISABLED_TOOLS mit einer durch Kommas getrennten Liste von Toolnamen verwenden.

export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema"

Telemetrie

Standardmäßig sammelt der MongoDB MCP Server anonyme Nutzungsdaten, um das Produkt zu verbessern. Wenn Sie dies deaktivieren möchten, können Sie das Befehlszeilenargument --telemetry disabled oder die Umgebungsvariable MDB_MCP_TELEMETRY=disabled verwenden.

Docker-Installation

Für diejenigen, die eine containerisierte Umgebung bevorzugen, kann der MongoDB MCP Server in einem Docker-Container ausgeführt werden. Dies bietet Isolation und macht eine lokale Node.js-Installation überflüssig.

So führen Sie den Server mit einer Verbindungszeichenfolge aus:

docker run --rm -i -e MDB_MCP_CONNECTION_STRING="your-mongodb-connection-string" mongodb/mongodb-mcp-server:latest

So führen Sie ihn mit Atlas API-Anmeldedaten aus:

docker run --rm -i -e MDB_MCP_API_CLIENT_ID="your-atlas-api-client-id" -e MDB_MCP_API_CLIENT_SECRET="your-atlas-api-client-secret" mongodb/mongodb-mcp-server:latest

Sie würden dann Ihren MCP-Client so konfigurieren, dass er den Befehl docker anstelle von npx verwendet. Zum Beispiel in Claude Desktop:JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MDB_MCP_API_CLIENT_ID=your-atlas-api-client-id",
        "-e",
        "MDB_MCP_API_CLIENT_SECRET=your-atlas-api-client-secret",
        "mongodb/mongodb-mcp-server:latest"
      ]
    }
  }
}

Fazit

Der MongoDB MCP Server stellt einen bedeutenden Fortschritt bei der Integration von KI und Datenbanken dar. Durch die Bereitstellung einer standardisierten Methode für KI-Clients zur Interaktion mit MongoDB eröffnet er Entwicklern eine Welt voller Möglichkeiten. Von der Abfrage und Datenexploration in natürlicher Sprache bis hin zur KI-unterstützten Datenbankadministration und Code-Generierung wird der MCP Server zu einem unverzichtbaren Werkzeug im modernen Entwickler-Toolkit werden.

Dieses Tutorial hat eine umfassende Anleitung zum Einstieg in den MongoDB MCP Server gegeben. Indem Sie diese Schritte befolgen, können Sie Ihre MongoDB-Bereitstellungen schnell und einfach mit Ihren bevorzugten KI-Tools verbinden und die Vorteile der KI-gestützten Entwicklung nutzen. Da es sich um eine neue und sich entwickelnde Technologie handelt, sollten Sie die offizielle MongoDB-Dokumentation und das GitHub-Repository auf die neuesten Updates und Funktionen überprüfen. Die Zukunft der Datenbankinteraktion ist da, und mit dem MongoDB MCP Server sind Sie an vorderster Front dabei.

💡

button