MongoDB MCP-Server

Eine leistungsstarke Model Context Protocol (MCP)-Serverimplementierung, die eine nahtlose Interaktion mit MongoDB-Datenbanken über ein standardisiertes Protokoll ermöglicht.

Autor

Rastalion

Gliederung

Diese MCP-Serverimplementierung bietet eine leistungsstarke Schnittstelle zur Interaktion mit einer MongoDB-Datenbank über das Model Context Protocol. Es bietet zuverlässige Unterstützung für Vorgänge an Datenbanken, Sammlungen und Dokumenten mit dem Async/Await-Muster und der Fehlerbehandlung.

Merkmal

Vollständige Unterstützung für MongoDB CRUD-Operationen
Handhabung sicherer Verbindungen zu MongoDB
Async/Await-Muster für optimale Leistung
Umfassende Fehlerbehandlung
Docker-Unterstützung für einfache Bereitstellung
Ausführen von Abfragen mit Typhinweisen
Unterstützung für Server-Sent Events (SSE) für Echtzeit-Updates

Schnellstart

Verwendung als CLI-Tool

# 저장소 복제
git clone https://github.com/yourusername/mongo-mcp-server.git
cd mongo-mcp-server

# 개발 모드로 설치
pip install -e .

# 로컬에서 CLI 명령으로 실행
mongo-mcp-server

# SSE 트랜스포트로 실행
mongo-mcp-server --transport=sse

# MongoDB URL 지정
mongo-mcp-server --mongodb-url="mongodb://username:password@hostname:port/dbname"

# 도움말 보기
mongo-mcp-server --help

Ausführung über UVX

# UVX가 설치된 경우
uvx mongo-mcp-server

# SSE 트랜스포트 모드
uvx mongo-mcp-server --transport=sse

Python direkt ausführen

# 저장소 복제
git clone https://github.com/yourusername/mongo-mcp-server.git
cd mongo-mcp-server

# 의존성 설치
pip install -r requirements.txt

# 환경 변수 설정
export MONGODB_URL="mongodb://username:password@hostname:port/dbname?authSource=admin"

# 서버 실행
uvicorn app.main:app --host 0.0.0.0 --port 3000

Verwenden von Docker

# 저장소 복제
git clone https://github.com/yourusername/mongo-mcp-server.git
cd mongo-mcp-server

# Docker Compose로 빌드 및 실행
docker-compose up -d

# 로그 확인
docker-compose logs -f mongo-mcp

Verwenden von UVX

UVX ist ein Tool, mit dem Sie Dienste in verschiedenen Umgebungen einfach verwalten können.

# 등록 스크립트에 실행 권한 부여
chmod +x uvx-register.sh

# UVX에 서비스 등록
./uvx-register.sh

# 서비스 시작
uvx start mongo-mcp

# 상태 확인
uvx status mongo-mcp

# 로그 확인
uvx logs mongo-mcp

Weitere Informationen finden Sie im UVX-Handbuch .

Umgebungsvariablen

Legen Sie vor dem Ausführen des Servers die folgenden Umgebungsvariablen fest:

# 필수
MONGODB_URL="mongodb://username:password@hostname:port/dbname?authSource=admin"

# 선택 - 기본값 표시
PORT=3000
MCP_TRANSPORT=http  # 'http' 또는 'sse'

API-Endpunkt

Überprüfen Sie den Zustand : GET /health
MCP-API : GET /mcp – FastMCP-Endpunkt (OpenAPI-Dokumentation)
SSE-Verbindung : GET /sse – Endpunkt für vom Server gesendete Ereignisse
Nachrichtenverarbeitung : POST /messages – Endpunkt der Nachrichtenverarbeitung

IDE-Integration

VS Code-Einstellungen

Fügen Sie Ihrer VS Code-Datei „settings.json“ Folgendes hinzu:

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "mongodbUri",
        "description": "MongoDB 연결 URI"
      }
    ],
    "servers": {
      "mongodb": {
        "command": "mongo-mcp-server",
        "args": ["--mongodb-url", "$(mongodbUri)"],
        "env": {}
      }
    }
  }
}

Claude oder ein anderer KI-Assistent

Konfigurieren Sie Ihren MCP-Server für Claude oder andere KI-Assistenten wie folgt:

{
  "mcp": {
    "servers": {
      "mongodb": {
        "url": "http://localhost:3000/mcp"
      }
    }
  }
}

Verfügbare Tools

Werkzeugname	Erläuterung
`listCollections`	Alle verfügbaren Sammlungen in der Datenbank auflisten
`find`	Abrufen von Dokumenten in einer Sammlung mithilfe der MongoDB-Abfragesyntax
`insertOne`	Einfügen eines einzelnen Dokuments in eine Sammlung
`updateOne`	Aktualisieren eines einzelnen Dokuments in einer Sammlung
`deleteOne`	Löschen eines einzelnen Dokuments aus einer Sammlung
`indexes`	Alle Indizes in einer Sammlung auflisten
`createIndex`	Erstellen eines neuen Index in einer Sammlung
`dropIndex`	Löschen eines vorhandenen Indexes aus einer Sammlung

Erweiterte Nutzung

Hinzufügen benutzerdefinierter Tools

Erstellen Sie ein neues Tool in app/tools/documents/ oder app/tools/collection/ :

from ..base.tool import BaseTool

class MyNewTool(BaseTool):
    @property
    def name(self) -> str:
        return "my_new_tool"

    @property
    def description(self) -> str:
        return "새 도구에 대한 설명"

    @property
    def input_schema(self) -> Dict[str, Any]:
        return {
            "type": "object",
            "properties": {
                # 도구 입력 스키마 정의
            }
        }

    async def execute(self, params: Dict[str, Any]) -> Dict[str, Any]:
        # 도구 실행 로직 구현
        pass

Registrieren Sie das Tool in app/tools/registry.py :

from .documents.my_new_tool import MyNewTool

# ToolRegistry.__init__ 메서드 내에서
self.register_tool(MyNewTool())

Installieren und Bereitstellen von CLI-Tools

Sie können es global verfügbar machen, indem Sie es als Paket auf PyPI registrieren:

# setup.py 확인 후 빌드
python setup.py sdist bdist_wheel

# 패키지 업로드 (PyPI 계정 필요)
twine upload dist/*

# 전역 설치
pip install mongodb-mcp-bridge

# 어디서든 실행 가능
mongodb-mcp-bridge

Fehlerbehebung

Wenn der Server nicht startet : Überprüfen Sie die Hilfe mit mongo-mcp-server --help
MongoDB-Verbindungsproblem : Überprüfen Sie, ob --mongodb-url korrekt ist
Fehler bei der Toolausführung : Überprüfen Sie die Toolimplementierung und die Eingabeparameter
Docker-Problem : Überprüfen Sie die Protokolle mit docker-compose logs mongo-mcp

Docker-Konfiguration

Die Docker-Konfiguration umfasst:

Python 3.12-Basisimage
Zeitzone Asien/Seoul
MongoDB 4.4-Instanz
Persistente Volumes zur Datenbankspeicherung
Integritätsprüfung für beide Dienste
Automatisierte Netzwerkkonfiguration

Lizenz

Dieses Projekt wird unter der MIT-Lizenz vertrieben – Einzelheiten finden Sie in der Datei LICENSE .

MongoDB MCP Server

Integrations