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。