Mongodb MCP

🚀 MongoDB MCP 服務器

MongoDB MCP 服務器是一個提供只讀訪問 MongoDB 數據庫的模型上下文協議（MCP）服務器，它藉助標準化的工具和資源，為 AI 助手賦予強大的數據探索能力。

🚀 快速開始

此 MongoDB MCP 服務器允許 AI 助手直接對 MongoDB 數據庫進行查詢和分析。它被設計為只讀訪問模式，在保障數據安全的同時，提供了強大的數據探索功能。

✨ 主要特性

MongoDB 操作

• 數據庫探索：可列出所有數據庫和集合。
• 模式發現：能從樣本文檔中推斷集合的模式。
• 查詢執行：可執行帶有過濾、投影、排序和限制的 MongoDB 查詢。
• 聚合：可運行經過安全驗證的只讀聚合管道。
• 全文搜索：能對具有文本索引的集合執行全文搜索。
• 空間查詢：可查找靠近點、位於多邊形內或與幾何形狀相交的位置。
• 文檔操作：可統計文檔數量、隨機採樣文檔、通過 ID 查找文檔。
• 數據分析：可獲取集合統計信息、索引信息和查詢執行計劃。
• 性能洞察：可檢查查詢執行計劃以優化性能。
• 數據探索：可獲取不同值、字段分佈和數據樣本。
• 格式轉換：可將查詢結果導出為 JSON 或 CSV 格式。

增強功能

• 模式推理：自動檢測文檔中的數據類型和結構。
• 智能可視化提示：基於結果內容給出智能數據可視化建議。
• 安全驗證：防止聚合管道中的寫操作。
• 示例豐富的文檔：每個工具在描述中都包含詳細的示例。

📦 安裝指南

從源代碼構建

安裝依賴項：

npm install

構建服務器：

npm run build

開發時自動重建：

npm run watch

與 Claude 桌面集成

要在 Claude 桌面中使用，請添加服務器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mongodb": {
      "command": "/path/to/mongodb-server/build/index.js",
      "env": {
        "MONGODB_URI": "mongodb://username:password@hostname:port/database",
        "MONGODB_DEFAULT_DATABASE": "your_default_db"
      }
    }
  }
}

與 Claude Web 集成

通過 MCP Chrome 擴展在 Claude Web 中使用，請將配置添加到 Cline MCP 設置中：

{
  "mcpServers": {
    "mongodb": {
      "command": "node",
      "args": ["/path/to/mongodb-server/build/index.js"],
      "env": {
        "MONGODB_URI": "mongodb://username:password@hostname:port/database",
        "MONGODB_DEFAULT_DATABASE": "your_default_db"
      }
    }
  }
}

與 Claude Code 集成

要在 Claude Code 中使用，請執行以下命令：

cd /path/to/my/project
claude mcp add mongo-server /path/to/mongodb-mcp/build/index.js -e "MONGODB_URI=mongodb://user@password:27017/dbname?authSource=authDbName" -e MONGO_DEFAULT_DATABASE=dbname 

請確保將佔位符替換為實際的 MongoDB 連接字符串和默認數據庫名稱。

📚 詳細文檔

要求

環境變量

• MONGODB_URI（必需）：MongoDB 連接字符串，如果需要身份驗證則包含用戶名和密碼。
• MONGODB_DEFAULT_DATABASE（可選）：未指定時使用的默認數據庫名稱。

決條件

• 對 MongoDB 服務器的網絡訪問權限。
• 如果 MongoDB 實例要求身份驗證，則提供相應的認證憑證。
• 目標數據庫上的適當讀取權限。

調試

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能會具有挑戰性。使用可用的 MCP 檢查器，它是作為包腳本提供的：

npm run inspector

檢查器將提供一個可以在瀏覽器中訪問調試工具的 URL。