Mongodb Developer Mongodb MCP Server

🚀 MongoDB MCP 服務器

MongoDB MCP 服務器是一個基於模型上下文協議（Model Context Protocol）的服務器，它提供對 MongoDB 數據庫的只讀訪問。藉助該服務器，大型語言模型（LLM）能夠檢查集合模式並執行聚合管道，為數據查詢和分析提供便利。

✨ 主要特性

• 提供對 MongoDB 數據庫的只讀訪問。
• 支持大型語言模型（LLM）檢查集合模式和執行聚合管道。
• 具備多種工具和資源，方便數據操作和信息獲取。
• 擁有安全特性，保障數據操作的安全性。

📦 安裝指南

要在 Claude Desktop 應用中使用此服務器，請在 claude_desktop_config.json 文件的 "mcpServers" 部分添加以下配置：

"mongodb": {
      "command": "npx",
      "args": [
        "-y" ,
        "@pash1986/mcp-server-mongodb"
      ],
     "env" : {
	"MONGODB_URI" : "mongodb+srv://<yourcluster>" // 'mongodb://localhost:27017'
	}
    }

將 mydb 替換為您的數據庫名稱，並根據需要調整連接字符串。

💻 使用示例

基礎用法

基本聚合查詢

{
  "collection": "users",
  "pipeline": [
    { "$match": { "age": { "$gt": 21 } } },
    { "$group": {
      "_id": "$city",
      "avgAge": { "$avg": "$age" },
      "count": { "$sum": 1 }
    }},
    { "$sort": { "count": -1 } },
    { "$limit": 10 }
  ],
  "options": {
    "allowDiskUse": true,
    "maxTimeMS": 60000,
    "comment": "City-wise user statistics"
  }
}

查詢解釋

{
  "collection": "users",
  "pipeline": [
    { "$match": { "age": { "$gt": 21 } } },
    { "$sort": { "age": 1 } }
  ],
  "verbosity": "executionStats"
}

🔧 技術細節

工具

• aggregate

  • 功能：執行 MongoDB 聚合管道操作。
  • 輸入參數：
    • collection (字符串)：要查詢的集合名稱。
    • pipeline (數組)：MongoDB 聚合管道階段。
    • options (對象)：可選聚合設置。
      • allowDiskUse (布爾值)：允許使用磁盤操作。
      • maxTimeMS (數字)：最大執行時間（以毫秒為單位）。
      • comment (字符串)：標識操作的註釋。
  • 默認設置：
    • 如果沒有指定限制階段，默認限制為 1000 條文檔。
    • 默認超時時間為 30 秒。

• explain

  • 功能：獲取聚合管道的執行計劃。
  • 輸入參數：
    • collection (字符串)：要分析的集合名稱。
    • pipeline (數組)：MongoDB 聚合管道階段。
    • verbosity (字符串)：解釋的詳細程度。
      • 可選值："queryPlanner", "executionStats", "allPlansExecution"。
      • 默認值："queryPlanner"。

資源

該服務器提供每個集合的模式信息：

• 集合模式 (mongodb://<host>/<collection>/schema)
  • 集合文檔樣本推導出的 JSON 模式信息。
  • 包括字段名稱和數據類型。
  • 模式是從集合文檔樣本中推導出來的。

🔒 安全特性

• 文檔限制：默認情況下，如果沒有在管道中指定限制，默認限制為 1000 條文檔。
• 超時設置：默認超時時間為 30 秒。
• 只讀操作：服務器僅支持只讀操作，保障數據安全。
• 模式推斷：從集合樣本中安全推斷模式。

📄 許可證

此 MCP 服務器根據 MIT License 發佈。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關更多詳細信息，請參見項目存儲庫中的 LICENSE 文件。