MongoDB MCP Server

MongoDB MCP 服务

一个模型上下文协议服务，通过标准化的 MCP 工具和资源提供对 MongoDB 数据库的只读访问。

概述

这个 MongoDB MCP 服务支持 AI 助手直接查询和分析 MongoDB 数据库，同时不提供写入权限，从而在保障数据安全的同时提供强大的数据探索能力。

功能

MongoDB 操作

• 数据库探索：列出数据库和集合
• 架构发现：根据示例文档推断集合架构
• 查询：执行 MongoDB 查询，支持筛选、投影、排序和限制结果数量
• 聚合：运行只读聚合管道，并进行安全验证
• 文本搜索：在包含文本索引的集合中执行全文搜索
• 地理空间查询：查找点附近、多边形内或与几何图形相交的位置
• 文档操作：统计文档数量、随机抽取文档、按 ID 查找文档
• 数据分析：获取集合统计信息、索引信息和查询执行计划
• 性能洞察：检查查询执行计划以优化性能
• 数据探索：获取不同值、字段分布和数据样本
• 格式转换：将查询结果导出为 JSON 或 CSV 格式

增强功能

• 架构推断：自动检测文档中的数据类型和结构
• 可视化提示：根据结果内容智能提供数据可视化建议
• 安全验证：防止在聚合管道中执行写入操作
• 丰富示例的文档：每个工具的说明中都包含详细示例

要求

环境变量

• MONGODB_URI（必填）：MongoDB 连接字符串，如有需要请包含身份验证信息
• MONGODB_DEFAULT_DATABASE（可选）：查询未指定数据库时使用的默认数据库名称

先决条件

• 可访问 MongoDB 服务的网络连接
• 如果 MongoDB 实例要求身份验证，则需提供相应凭据
• 对目标数据库具有适当的读取权限

安装

从源代码构建

安装依赖项：

npm install

构建服务：

npm run build

开发时启用自动重新构建：

npm run watch

与 Claude Desktop 集成

如需与 Claude Desktop 搭配使用，请添加服务配置：

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 连接字符串和默认数据库名称。

如果配置正确，运行 claude 时应会看到以下内容：

╭───────────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code research preview!            │
│                                                       │
│   /help for help                                      │
│                                                       │
│   cwd: <path-to-project-directory>                    │
│                                                       │
│   ─────────────────────────────────────────────────── │
│                                                       │
│   MCP Servers:                                        │
│                                                       │
│   • mongo-server                            connected │
╰───────────────────────────────────────────────────────╯

如果遇到问题，请参阅 Claude Code文档。

安全注意事项

• 此服务在设计上仅提供只读访问
• 连接字符串可能包含敏感的身份验证信息
• 请将连接字符串安全地存储在环境变量中
• 请使用具有只读权限的 MongoDB 用户

调试

由于 MCP 服务通过标准输入输出（stdio）通信，调试可能颇具挑战。请使用 MCP Inspector，它可通过包脚本运行：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。