MongoDB MCP Server

社区

让 AI 助手安全地连接 MongoDB 数据库，自动发现集合结构，完成查询与写入。

分类: 数据库第 54 / 58
Stars: ★ 282 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 20+
凭据: 无需凭据
许可证: MIT
最近提交: 2 个月前
工具数: 8

42FMRS · D

mcp-mongo-server 是一个功能丰富的 MongoDB MCP 服务器，提供只读模式、模式推断、查询聚合等特性，通过 npx 即可快速使用。它的设计注重安全，默认限制跨库操作和服务端 JS。适合开发者在 AI 编程工具中安全地探索和操作 MongoDB。

最强项 · 文档质量 13/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

7/20

维护活跃度

6/20

文档质量

13/20

安装易用性

11/20

查看各项评分依据

可靠性 5/20: 仅凭 README 看到 npx 启动、stdio/http 传输和工具分类；未提供源码、CI 工作流或测试，无法验证 MCP 握手、工具清单与实际行为是否一致。按静态校准规则缺少执行证据，得分保守下调。
安全与权限 7/20: README 披露了只读模式、跨库聚合拦截、服务端 JS 拦截、HTTP Bearer token 和来源白名单，但均无源码佐证，无法确认这些防御真实生效。未发现安装示例含真实密钥或明显恶意行为；由于无法核验强制边界，扣分。
维护活跃度 6/20: 仓库未归档、有 MIT 许可证、开放 issue 仅 1 个，这些是正面信号；但未提供提交历史、版本发布、依赖更新或安全响应渠道，无法证实持续维护状态，因此低于活跃基准。
文档质量 13/20: README 提供了快速开始、CLI/环境变量、安全说明和文档链接，示例清楚并披露了只读/跨库/JS 限制；但缺少本地可查的完整工具参数说明和故障排查章节，且引用的 docs 目录内容未在本材料中，故未给满分。
安装易用性 11/20: 需要 Node.js 20+，npx 一行启动，支持 stdio/http 和多个环境变量，步骤清晰；但 README 未直接给出 Claude Desktop/Cursor 等客户端的配置示例，且无 CI/测试验证安装过程，按静态校准上限 15 仍给保守分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么连接数据库

适合谁

需要与 MongoDB 交互的 AI 编程助手（如 Claude Desktop、Cursor、Windsurf）用户
希望以自然语言方式查询数据库的开发者
需要在团队中共享 MongoDB 数据访问的场景

不适合谁

需要高安全性生产环境的场景，除非已配置好认证和权限
对数据库性能有严格要求的场景（AI 助手可能执行非最优查询）
需要完整数据库管理功能（如用户管理、备份）的用户

所需权限

连接 MongoDB 的连接字符串，可包含用户名和密码
对目标数据库的读写权限（除非启用只读模式）
HTTP 模式下可能需要认证令牌

风险与副作用

如果未启用只读模式，AI 可能意外执行写操作（如更新、插入、创建索引）
默认禁止跨数据库操作，但使用 --allow-cross-db 可能泄露其他数据库的数据
服务器端 JavaScript 操作（$function, $where）默认禁用，但启用可能带来代码执行风险
HTTP 模式默认只允许 localhost，但错误配置可能暴露数据库
可能执行资源密集的聚合或查询，导致性能问题

安装接入

准备工作

运行环境：Node.js 20+

MCP_MONGODB_URI 可选密钥 MongoDB 连接 URI，可作为命令行参数的替代；使用本地或 Atlas 数据库的连接字符串。

MCP_HTTP_AUTH_TOKEN 可选密钥访问 HTTP 端点所需的 Bearer 令牌，自行设定后用于 Authorization 头。

其他可选配置项（6 个）

MCP_MONGODB_READONLY 可选设为 "true" 启用只读模式，阻止所有写操作。

MCP_MONGODB_ALLOW_CROSS_DB 可选设为 "true" 允许跨数据库聚合操作（默认关闭）。

MCP_MONGODB_ALLOW_SERVER_JS 可选设为 "true" 允许服务端 JavaScript 操作符（默认关闭）。

MCP_PORT 可选 HTTP 模式的端口号（默认 3001）。

MCP_HTTP_ALLOWED_ORIGINS 可选 HTTP 模式下允许的浏览器来源，逗号分隔。

MCP_HTTP_JSON_LIMIT 可选 HTTP 请求体大小上限（默认 10mb）。

无需安装步骤，直接使用 npx 运行：npx -y mcp-mongo-server mongodb://localhost:27017/mydatabase

验证是否装好

在客户端工具列表中应出现 query、insert、listCollections、inferSchema 等工具；让 AI 运行 listCollections，能返回集合名称即说明连接成功。

常见排障

检查 MongoDB URI 是否正确，数据库是否可达
确认 Node.js 版本 >= 20
如果写入失败，检查是否启用了只读模式
HTTP 模式下如果收到 403，检查 Origin 是否允许
查看文档 docs/integration.md 获取客户端配置示例

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出数据库中的所有集合
推断 orders 集合的 schema
查询 orders 集合里最近 10 条记录
把时间戳 1700000000 转换成 ISO 时间

工具能力 8

query 只读

查询集合中的文档，支持筛选条件、投影等。

aggregate 只读

执行聚合管道，可生成 explain 计划。

update 写入

更新集合中的文档（非只读模式下）。

insert 写入

插入新文档到集合（非只读模式下）。

createIndex 写入

在集合上创建索引（非只读模式下）。

convertTime 只读

将 Unix 时间戳或日期字符串转换为 UTC/GMT/ISO 格式。

listCollections 只读

列出数据库中的集合。

inferSchema 只读

从文档样本推断集合的模式。

使用场景

让 AI 助手用自然语言查询 MongoDB 中的数据

自动探索数据库结构，了解集合和字段

在只读模式下让 AI 安全地分析数据而不修改

通过 HTTP 端点提供远程访问或多人使用

支持客户端

Claude Desktop

Cursor

Windsurf

依据项目文档列出，未经本站实测。

详细介绍

mcp-mongo-server 是一个 Model Context Protocol (MCP) 服务器，允许 AI 助手与 MongoDB 数据库交互。它会自动暴露集合、推断其模式，并通过标准接口运行查询、聚合和写入操作。支持只读模式、智能 ObjectId 处理、模式推断、聚合管道、time 转换以及进度和取消功能。可通过 stdio 或 HTTP 传输，兼容 Claude Desktop、Cursor 和 Windsurf 等客户端。