Mongo MCP

🚀 🗄️ MongoDB MCP 服務器用於 LLM

這是一個模型上下文協議（MCP）服務器，能讓大型語言模型（LLMs）直接與 MongoDB 數據庫交互。藉助它，用戶可通過自然語言查詢集合、檢查模式、分析數據並進行管理。

🚀 快速開始

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

MacOS: ~/Library/Application\ Support/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 安裝：

smithery install --package mongo-mcp

然後在 smithery.toml 中添加以下內容：

[mongo-mcp]
command = "node"
args = ["index.js"]

✨ 主要特性

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

🎥 演示視頻

點擊查看演示視頻

📦 安裝指南

📋 先決條件

• Node.js（版本 18+）
• npm 或 yarn
• Docker（用於可選的沙箱環境）

🔧 安裝依賴項

使用以下命令安裝項目依賴：

npm install

或

yarn install

🚀 啟動服務器

要啟動 MCP 服務器，請運行：

npm start

或

yarn start

💻 使用示例

測試環境設置

使用 Docker 啟動 MongoDB

您可以使用以下命令在 Docker 中啟動 MongoDB：

docker run --name mcp-mongo -d mongo:latest

然後，您可以通過以下命令連接到 MongoDB 實例：

mongo --host localhost --port 27017

創建測試數據

要填充測試數據，請運行以下命令：

npx mongo-mcp create-users-collection

測試沙箱數據結構

用戶集合

用戶集合包含以下字段：

• _id: 文檔 ID
• username: 用戶名
• email: 電子郵件地址
• password: 密碼哈希
• created_at: 創建時間戳
• updated_at: 更新時間戳

示例文檔：

{
  "_id": "63b4d207f8dfg5c1a7b1",
  "username": "exampleuser",
  "email": "user@example.com",
  "password": "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKfW3p2.tU6VNU.0oGoeHabKN0u8F",
  "created_at": "2023-07-20T12:00:00Z",
  "updated_at": "2023-07-20T12:00:00Z"
}

產品集合

產品集合包含以下字段：

• _id: 文檔 ID
• name: 產品名稱
• price: 價格（貨幣單位）
• description: 描述
• category: 分類
• stock: 庫存數量
• created_at: 創建時間戳

示例文檔：

{
  "_id": "63b4d207f8dfg5c1a7b2",
  "name": "Example Product",
  "price": 9.99,
  "description": "This is an example product.",
  "category": "electronics",
  "stock": 10,
  "created_at": "2023-07-20T12:00:00Z"
}

訂單集合

訂單集合包含以下字段：

• _id: 文檔 ID
• user_id: 用戶 ID（引用用戶集合的 _id）
• products: 訂單中的產品列表（數組，包含產品 ID 和數量）
• total_price: 總價格（貨幣單位）
• order_date: 下單日期時間戳
• status: 訂單狀態（如 "pending", "processing", "shipped", "delivered"）

示例文檔：

{
  "_id": "63b4d207f8dfg5c1a7b3",
  "user_id": "63b4d207f8dfg5c1a7b1",
  "products": [
    {
      "product_id": "63b4d207f8dfg5c1a7b2",
      "quantity": 2
    }
  ],
  "total_price": 19.98,
  "order_date": "2023-07-20T12:00:00Z",
  "status": "pending"
}

🛠️ 可用工具

命令列表

以下是一些可用的命令及其功能：

索引管理

• create-collection: 創建一個新的 MongoDB 集合。
• drop-collection: 刪除指定的 MongoDB 集合。
• add-index: 為指定集合添加索引。
• remove-index: 從指定集合中刪除索引。

數據操作

• insert-doc: 插入單個文檔到指定集合。
• batch-insert: 批量插入多個文檔到指定集合。
• find-docs: 查詢指定集合中的所有文檔（可選條件）。
• update-doc: 更新指定集合中的一個或多個文檔。
• delete-doc: 刪除指定集合中的一個或多個文檔。

📄 許可證

本項目受 MIT License 保護。

如需進一步瞭解，請參考項目的完整文檔。