MCP MongoDB Server

Ein Model Context Protocol-Server, der LLMs die Interaktion mit MongoDB-Datenbanken ermöglicht. Dieser Server bietet Funktionen zur Überprüfung von Sammlungsschemata und zur Ausführung von MongoDB-Operationen über eine standardisierte Schnittstelle.

Demo

Hauptmerkmale

Intelligente Objekt-ID-Behandlung

• Intelligente Konvertierung zwischen String-IDs und MongoDB ObjectId

• Konfigurierbar mit dem Parameter objectIdMode :

  • "auto" : Konvertierung basierend auf Feldnamen (Standard)

  • "none" : Keine Konvertierung

  • "force" : Erzwingt die ObjectId aller String-ID-Felder

Flexible Konfiguration

• Umgebungsvariablen :

  • MCP_MONGODB_URI : MongoDB-Verbindungs-URI

  • MCP_MONGODB_READONLY : Aktiviert den Nur-Lese-Modus, wenn auf „true“ gesetzt

• Befehlszeilenoptionen :

  • --read-only oder -r : Verbindung im schreibgeschützten Modus herstellen

Schreibgeschützter Modus

• Schutz vor Schreiboperationen (Update, Insert, CreateIndex)

• Nutzt die sekundäre Lesepräferenz von MongoDB für optimale Leistung

• Ideal für die sichere Verbindung mit Produktionsdatenbanken

MongoDB-Operationen

• Lesevorgänge :

  • Abfragedokumente mit optionaler Ausführungsplananalyse

  • Ausführen von Aggregationspipelines

  • Zählen Sie Dokumente, die den Kriterien entsprechen

  • Abrufen von Sammlungsschemainformationen

• Schreibvorgänge (wenn nicht im Nur-Lese-Modus):

  • Dokumente aktualisieren

  • Neue Dokumente einfügen

  • Erstellen von Indizes

LLM-Integration

• Sammlungsvervollständigungen für eine verbesserte LLM-Interaktion

• Schemainferenz für ein besseres Kontextverständnis

• Sammlungsanalyse für Dateneinblicke

Installation

Globale Installation

Für die Entwicklung

Verwendung

Grundlegende Verwendung

Umgebungsvariablen

Sie können den Server mithilfe von Umgebungsvariablen konfigurieren. Dies ist besonders nützlich für CI/CD-Pipelines, Docker-Container oder wenn Sie keine Verbindungsdetails in Befehlsargumenten offenlegen möchten:

Verwenden von Umgebungsvariablen in der Claude Desktop-Konfiguration:

Verwenden von Umgebungsvariablen mit Docker:

Integration mit Claude Desktop

Manuelle Konfiguration

Fügen Sie die Serverkonfiguration zur Konfigurationsdatei von Claude Desktop hinzu:

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

Ansatz mit Befehlszeilenargumenten:

Ansatz mit Umgebungsvariablen:

GitHub-Paketnutzung:

Integration mit Windsurf und Cursor

Der MCP MongoDB-Server kann mit Windsurf und Cursor auf ähnliche Weise wie Claude Desktop verwendet werden.

Windsurf-Konfiguration

Fügen Sie den Server zu Ihrer Windsurf-Konfiguration hinzu:

Cursorkonfiguration

Fügen Sie für Cursor die Serverkonfiguration zu Ihren Einstellungen hinzu:

Sie können den Ansatz mit Umgebungsvariablen auch sowohl mit Windsurf als auch mit Cursor verwenden und dabei dem gleichen Muster folgen, das in der Claude Desktop-Konfiguration gezeigt wird.

Automatisierte Installation

Schmiedearbeiten verwenden :

Verwenden von mcp-get :

Verfügbare Tools

Abfragevorgänge

• Abfrage : Führen Sie MongoDB-Abfragen aus

  { collection: "users", filter: { age: { $gt: 30 } }, projection: { name: 1, email: 1 }, limit: 20, explain: "executionStats" // Optional }

• aggregate : Führen Sie Aggregationspipelines aus

  { collection: "orders", pipeline: [ { $match: { status: "completed" } }, { $group: { _id: "$customerId", total: { $sum: "$amount" } } } ], explain: "queryPlanner" // Optional }

• count : Zählt übereinstimmende Dokumente

  { collection: "products", query: { category: "electronics" } }

Schreibvorgänge

• Update : Dokumente ändern

  { collection: "posts", filter: { _id: "60d21b4667d0d8992e610c85" }, update: { $set: { title: "Updated Title" } }, upsert: false, multi: false }

• einfügen : Neue Dokumente hinzufügen

  { collection: "comments", documents: [ { author: "user123", text: "Great post!" }, { author: "user456", text: "Thanks for sharing" } ] }

• createIndex : Sammlungsindizes erstellen

  { collection: "users", indexes: [ { key: { email: 1 }, unique: true, name: "email_unique_idx" } ] }

Systembetrieb

• serverInfo : MongoDB-Serverdetails abrufen

  { includeDebugInfo: true // Optional }

Debuggen

Da MCP-Server über Standarddio kommunizieren, kann das Debuggen schwierig sein. Verwenden Sie den MCP-Inspektor für bessere Übersicht:

Dadurch wird eine URL für den Zugriff auf die Debugging-Tools in Ihrem Browser bereitgestellt.

Ausführen von Evaluierungen

Das Evals-Paket lädt einen MCP-Client, der anschließend die Datei index.ts ausführt, sodass zwischen den Tests kein Neuaufbau erforderlich ist. Sie können Umgebungsvariablen laden, indem Sie dem Befehl npx voranstellen. Die vollständige Dokumentation finden Sie hier .

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software unter den Bedingungen der MIT-Lizenz frei verwenden, ändern und verbreiten dürfen. Weitere Informationen finden Sie in der LICENSE-Datei im Projekt-Repository.