适合谁
- 需要与 MongoDB 交互的 AI 编程助手（如 Claude Desktop、Cursor、Windsurf）用户
- 希望以自然语言方式查询数据库的开发者
- 需要在团队中共享 MongoDB 数据访问的场景
M
42FMRS · D
mcp-mongo-server 是一个功能丰富的 MongoDB MCP 服务器，提供只读模式、模式推断、查询聚合等特性，通过 npx 即可快速使用。它的设计注重安全，默认限制跨库操作和服务端 JS。适合开发者在 AI 编程工具中安全地探索和操作 MongoDB。
mcp-mongo-server 是一个 Model Context Protocol (MCP) 服务器，允许 AI 助手与 MongoDB 数据库交互。它会自动暴露集合、推断其模式，并通过标准接口运行查询、聚合和写入操作。支持只读模式、智能 ObjectId 处理、模式推断、聚合管道、time 转换以及进度和取消功能。可通过 stdio 或 HTTP 传输，兼容 Claude Desktop、Cursor 和 Windsurf 等客户端。
工具能力
query
查询集合中的文档，支持筛选条件、投影等。
aggregate
执行聚合管道，可生成 explain 计划。
update
更新集合中的文档（非只读模式下）。
insert
插入新文档到集合（非只读模式下）。
createIndex
在集合上创建索引（非只读模式下）。
convertTime
将 Unix 时间戳或日期字符串转换为 UTC/GMT/ISO 格式。
listCollections
列出数据库中的集合。
inferSchema
从文档样本推断集合的模式。
安装接入
无需安装步骤，直接使用 npx 运行：npx -y mcp-mongo-server mongodb://localhost:27017/mydatabase
选型与风险
不适合谁
- 需要高安全性生产环境的场景，除非已配置好认证和权限
- 对数据库性能有严格要求的场景（AI 助手可能执行非最优查询）
- 需要完整数据库管理功能（如用户管理、备份）的用户
所需权限
- 连接 MongoDB 的连接字符串，可包含用户名和密码
- 对目标数据库的读写权限（除非启用只读模式）
- HTTP 模式下可能需要认证令牌
风险与副作用
- 如果未启用只读模式，AI 可能意外执行写操作（如更新、插入、创建索引）
- 默认禁止跨数据库操作，但使用 --allow-cross-db 可能泄露其他数据库的数据
- 服务器端 JavaScript 操作（$function, $where）默认禁用，但启用可能带来代码执行风险
- HTTP 模式默认只允许 localhost，但错误配置可能暴露数据库
- 可能执行资源密集的聚合或查询，导致性能问题
常见排障
- 检查 MongoDB URI 是否正确，数据库是否可达
- 确认 Node.js 版本 >= 20
- 如果写入失败，检查是否启用了只读模式
- HTTP 模式下如果收到 403，检查 Origin 是否允许
- 查看文档 docs/integration.md 获取客户端配置示例
使用场景
让 AI 助手用自然语言查询 MongoDB 中的数据
自动探索数据库结构，了解集合和字段
在只读模式下让 AI 安全地分析数据而不修改
通过 HTTP 端点提供远程访问或多人使用
支持客户端
Claude Desktop完整支持
Cursor完整支持
Windsurf完整支持