MongoDB MCP Server是什么｜能力、安装与使用方法

MongoDB MCP Server 是什么？

MongoDB MCP Server 是 MongoDB 官方的数据库与 Atlas 连接器。接入后，Codex 可以查看数据库、集合、索引和样例文档，也能在授权范围内运行查询或管理 Atlas 资源。

一句话理解连接 MongoDB 数据库和 Atlas 项目，用于检查集合、查询数据和受控管理。

为什么需要它？

让数据库结构和真实查询结果进入开发上下文，同时用只读模式限制初始风险。

接入前，AI 只能依赖你粘贴的材料、截图或旧上下文；接入后，它可以在你授权的范围内调用真实工具，并把结果、来源和状态带回当前任务。

核心能力

列出数据库、集合与索引

执行受控查询和聚合

在授权时访问 Atlas 管理能力

适合谁？怎么用？

适合使用

查看 MongoDB 集合、文档和 Atlas 状态
使用 MongoDB 或 Atlas，并需要在开发任务中检查模式、样例数据与项目状态的团队。
数据库、集合、字段和样例数量与 Atlas 或客户端一致。

不适合

不适合把生产 URI 放进公开配置，也不适合未经审批执行删除或迁移。
连接串可能授予数据库和 Atlas 管理权限
查询结果可能含个人或业务数据

怎么接入？

1
准备
准备已经运行且已获授权的测试 MongoDB；下方例子使用本机 mcp_demo 数据库。
2
授权
以 MDB_MCP_CONNECTION_STRING 指定连接地址，含密码的 URI 通过 env_vars 转发。
3
连接
登记 mongodb-mcp-server@latest 并保留 --readOnly，然后重新打开客户端任务。
4
开始使用
只列出测试数据库的集合，再与数据库客户端核对；连接失败先检查地址、认证和网络。

安装命令

添加 MongoDB MCP Server

codex mcp add mongodb --env MDB_MCP_CONNECTION_STRING=mongodb://127.0.0.1:27017/mcp_demo -- npx -y mongodb-mcp-server@latest --readOnly

这是已运行本地测试 MongoDB、数据库为 mcp_demo 且本机连接无需凭证时的完整登记例，不负责安装数据库。--readOnly 限制可用工具。远程库使用管理员提供的受限 URI；含密码的 URI 不应直接写进命令历史，可在 Codex 的 MCP 配置中用 env_vars 转发 MDB_MCP_CONNECTION_STRING，并从持有该变量的环境启动 Codex。没有可达数据库、测试数据或授权时，应停在准备阶段。本轮未连接数据库。

检查命令

确认 MCP 已经登记

codex mcp list

接入前准备

Node.js 与 npx
MongoDB 连接串或 Atlas 凭证
优先只读数据库用户

官方帮助

官方文档与仓库MongoDB 官方仓库 问题反馈在 GitHub Issues 获取帮助

不想自己操作终端时，把下面整段发给 Codex。它会先核对官方说明和前置条件，遇到凭证或占位符会停下来询问。

发给 Codex

自助接入 MongoDB MCP Server

请帮我在当前电脑上接入并验证 MongoDB MCP Server。

官方来源：https://github.com/mongodb-js/mongodb-mcp-server
目标接入命令：codex mcp add mongodb --env MDB_MCP_CONNECTION_STRING=mongodb://127.0.0.1:27017/mcp_demo -- npx -y mongodb-mcp-server@latest --readOnly

请按以下步骤执行：
1. 先阅读官方 README，核对当前推荐接入方式与上述命令。如果官方说明已经变化，先告诉我差异，不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证，也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符，先列出需要我提供的值并停下来，不要自行猜测。
4. 条件满足后执行接入命令，再运行 codex mcp list，确认 MongoDB MCP Server 已登记，并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接：请用 MongoDB MCP 读取测试数据库的集合列表和字段样例，每个集合最多 3 条，不要更新文档。
6. 不要创建、修改、删除、发送内容，也不要连接生产环境；需要写权限或更高权限时先征求我确认。

复制完整指令，发给一个有终端和当前项目访问权限的 Codex 任务。
Codex 会先核对官方来源和本机环境；遇到 Token、项目 ID、路径或其他占位符时，应停下来向你确认。
接入后运行 codex mcp list，再用 MongoDB MCP Server 的小范围测试任务回读结果。

第一次调用示例

登记完成后，新开一个任务，按下面任务限定调用范围，先说清目标、范围和停止条件。

发给 Codex

第一次小范围任务

请用 MongoDB MCP 读取测试数据库的集合列表和字段样例，每个集合最多 3 条，不要更新文档。

怎样算成功

数据库、集合、字段和样例数量与 Atlas 或客户端一致。

先读取集合结构和索引。
使用限定字段与小 limit 的测试查询。
把返回结果与 MongoDB 客户端核对。
只有在单独授权后才启用写入或 Atlas 管理操作。

权限与安全

凭证与连接方式

本地 stdio；准备只读测试账号，通过安全环境变量提供连接信息。

连接串可能授予数据库和 Atlas 管理权限
查询结果可能含个人或业务数据
必须限制数据库、账号角色、返回数量和日志暴露