Mongodb Model Context Protocol MCP

🚀 MongoDB 模型上下文協議 (MCP) 服務器用於 LLM

一個 Model Context Protocol (MCP) 服務器，可讓大語言模型（LLM）直接與 MongoDB 數據庫進行交互。藉助它，用戶能通過自然語言查詢集合、檢查架構，還能對數據進行管理和處理。

✨ 主要特性

• 🔍 集合架構檢查
• 📊 文檔查詢和篩選
• 📈 索引管理
• 📝 文檔操作（插入、更新、刪除）

🎥 演示視頻

點擊查看

🚀 快速開始

配置啟動

要開始使用，您需要找到 MongoDB 連接 URL，並將以下配置添加到您的 Claude Desktop 配置文件中：

• MacOS：~/Library/Application\ 支持/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "mongo-mcp",
        "mongodb://<username>:<password>@<host>:<port>/<database>?authSource=admin"
      ]
    }
  }
}

使用 Smithery 安裝

您可以通過 Smithery 自動安裝 MongoDB MCP Server for Claude Desktop：

npx -y @smithery/cli install mongo-mcp --client claude

先決條件

• Node.js 18+
• npx
• Docker 和 Docker Compose（僅限本地沙盒測試）
• MCP 客戶端（例如 Claude Desktop App）

測試沙盒設置

如果您沒有 MongoDB 數據庫服務器可以連接，並且想要創建一個示例沙盒，請按照以下步驟操作：

1. 使用 Docker Compose 啟動 MongoDB：

docker-compose up -d

2. 運行 seed 腳本以創建測試數據：

npm run seed

配置 Claude Desktop

在不同操作系統下修改配置文件：

• MacOS 和 Linux：編輯 ~/.config/Claude/claude_config.json 文件，添加以下內容：

"mongo-mcp": {
  " connectionString": "mongodb://localhost:27017"
}

• Windows：編輯 %APPDATA%/Claude/claude_config.json 文件，添加類似的內容。

💻 使用示例

基礎用法

# 查詢所有文檔
/mongo-mcp --query '{"command": "findAll"}'

# 插入新文檔
/mongo-mcp --insert '{"name": "test", "value": 123}'

高級用法

# 按條件查找
/mongo-mcp --search '{"name": "test"}' --projection '{"_id": 0, "name": 1}'

# 更新文檔
/mongo-mcp --update '{"query": {"name": "test"}, "update": {"$set": {"value": 456}}}'

# 創建索引
/mongo-mcp --create-index '{"collection": "users", "index": { "field": 1 }}'

# 刪除索引
/mongo-mcp --drop-index '{"collection": "users", "indexName": "field_1"}'

📚 詳細文檔

可用工具

查詢工具

索引工具

📄 許可證

該項目使用 MIT License，有關詳細信息，請參閱 LICENSE 文件。