mcp-mongodb

用于将 Claude 连接到 MongoDB 的 MCP（Model Context Protocol）服务器。 通过此服务器，Claude 可以直接通过对话浏览、查询和修改您的 MongoDB 数据库。

功能 / 工具

Related MCP server: Mongo-MCP

系统要求

• Node.js ≥ 18（在 v22 上开发并测试）

• MongoDB 服务器（本地或 MongoDB Atlas）

安装

cd d:\mcp_server\mcp_mongodb
npm install

环境变量配置

Atlas URI 示例：

mongodb+srv://user:password@cluster0.xxxxx.mongodb.net/?retryWrites=true&w=majority

连接到 Claude Desktop

1. 打开配置文件：

   • Windows： %APPDATA%\Claude\claude_desktop_config.json （通常是 C:\Users\<您的用户名>\AppData\Roaming\Claude\claude_desktop_config.json）

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

2. 添加以下条目（请调整路径和凭据）：

{
  "mcpServers": {
    "mongodb": {
      "command": "node",
      "args": ["d:\\mcp_server\\mcp_mongodb\\index.js"],
      "env": {
        "MONGODB_URI": "mongodb://localhost:27017",
        "MONGODB_DB": "nama_database_anda"
      }
    }
  }
}

3. 保存文件，然后重启 Claude Desktop（完全退出后重新打开）。

4. 聊天框中的锤子/工具栏图标将显示 mcp-mongodb 工具。

在 Claude 中的使用示例

• "显示所有 MongoDB 数据库" → list_databases

• "数据库 toko 中有哪些集合？" → list_collections

• "查找销量最高的 10 个产品，按销量从高到低排序" → 使用 sort + limit 的 find

• "添加一个名为 'Kopi Arabika'、价格 85000 的新产品" → insert_one

• "将 'minuman' 类别所有产品的库存增加 10" → update_many

• "每月总销售额是多少？" → 使用 $group 的 aggregate

• "在 users 集合的 email 字段上创建唯一索引" → create_index

测试

协议冒烟测试（无需 MongoDB 运行）：

npm test

预期输出：

PASS: initialize — server=mcp-mongodb v1.0.0
PASS: tools/list — 25 tool terdaftar
PASS: tool inti tersedia — semua ada
PASS: tools/call merespons

冒烟测试中对 server_info 的调用在 MongoDB 未运行时将显示错误消息——这是正常现象， 反而证明了 RPC 通道正常工作。

安全与重要说明

• 使用具有最低必要权限的 MongoDB 账户。 如果您只希望 Claude 读取数据， 请在 MongoDB/Atlas 中创建只读用户。

• 不要将密码保存在提交到 git 的文件中。生产环境建议将 MONGODB_URI 存储在系统环境变量中， 而不是放在 config JSON 中。

• 破坏性操作受到保护：drop_database 和带空过滤器的 delete_many 要求显式确认 （confirm: true），但带特定过滤器的 update_many / delete_many 仍会直接执行—— 在批准之前请始终检查 Claude 的操作计划。

• 查询输出有限制（默认 50 个文档，最大 1000 个），以免超出 Claude 的上下文。

故障排查

项目结构

mcp_mongodb/
├── index.js           # Entry point: McpServer + StdioServerTransport
├── lib/
│   ├── connection.js  # Singleton MongoClient (lazy connect), env config
│   ├── helpers.js     # Result builder, parser JSON, util ObjectId
│   └── schemas.js     # Skema Zod bersama
├── tools/
│   ├── admin.js       # Info server, database, koleksi
│   ├── query.js       # Pembacaan data & agregasi
│   ├── documents.js   # Insert/update/replace/delete
│   └── indexes.js     # Manajemen index
└── test-smoke.js      # Smoke test JSON-RPC via stdio