MongoDB MCP Server

基本能力

产品定位

MongoDB MCP Server 是一个桥接 Claude 和 MongoDB 数据库的服务，通过标准化接口使 Claude 能够执行 MongoDB 查询和聚合操作，从而在对话中直接分析和处理数据。

核心功能

• MongoDB 聚合管道执行：在 MongoDB 集合上运行复杂的聚合管道
• 随机采样：从集合中检索随机文档样本
• 查询计划分析：获取聚合管道的执行计划以了解性能
• 安全连接：使用环境变量连接 MongoDB Atlas
• 简单集成：通过 MCP 系统与 Claude Desktop 配合工作

适用场景

• 从 MongoDB 集合中随机采样文档
• 执行复杂的聚合查询以分析数据
• 分析查询性能以优化 MongoDB 操作

工具列表

1. aggregate - 在指定集合上执行 MongoDB 聚合管道
2. sample - 从集合中返回随机文档样本
3. explain - 提供聚合管道的执行计划

常见问题解答

• 连接问题：检查连接字符串是否正确，确保 MongoDB 用户有适当权限
• Claude 集成问题：验证 Claude Desktop 配置是否正确，重启 Claude Desktop
• 调试：服务器包含详细的控制台日志，检查 Claude Desktop 日志中的消息

使用教程

使用依赖

• Node.js (v14 或更新版本)
• MongoDB Atlas 账户或 MongoDB 服务器
• Claude Desktop 应用程序

安装教程

1. 克隆仓库： bash git clone https://github.com/yourusername/mongodb-mcp-server.git cd mongodb-mcp-server

2. 安装依赖： bash npm install

3. 配置 Claude Desktop： json "mcpServers": { "mongo-simple-server": { "command": "node", "args": ["/path/to/mongo-mcp-server.js"], "env": { "MONGODB_URI": "mongodb+srv://username:password@host", "DEFAULT_DATABASE": "YourDatabaseName" } } }

4. 重启 Claude Desktop 以应用更改

调试方式

• 检查 Claude Desktop 日志中的错误信息
• 验证 MongoDB 连接字符串是否正确
• 确保环境变量已正确设置

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。