MongoDB MCP Server 是什么？
MongoDB MCP Server 是 MongoDB 官方的数据库与 Atlas 连接器。接入后，Codex 可以查看数据库、集合、索引和样例文档，也能在授权范围内运行查询或管理 Atlas 资源。
一句话理解连接 MongoDB 数据库和 Atlas 项目，用于检查集合、查询数据和受控管理。
为什么需要它？
让数据库结构和真实查询结果进入开发上下文，同时用只读模式限制初始风险。
接入前，AI 只能依赖你粘贴的材料、截图或旧上下文；接入后，它可以在你授权的范围内调用真实工具，并把结果、来源和状态带回当前任务。
核心能力
列出数据库、集合与索引
把真实信息带回当前任务，减少反复复制和手动核对。
执行受控查询和聚合
在明确授权范围内调用工具，并保留执行过程和结果。
在授权时访问 Atlas 管理能力
回读来源、状态与限制，方便继续处理和人工验收。
适合谁？怎么用？
- 查看 MongoDB 集合、文档和 Atlas 状态
- 使用 MongoDB 或 Atlas，并需要在开发任务中检查模式、样例数据与项目状态的团队。
- 数据库、集合、字段和样例数量与 Atlas 或客户端一致。
- 不适合把生产 URI 放进公开配置，也不适合未经审批执行删除或迁移。
- 连接串可能授予数据库和 Atlas 管理权限
- 查询结果可能含个人或业务数据
怎么接入？
- 1准备
创建只读测试用户并限制目标数据库。
- 2授权
按官方 README 用
npx -y mongodb-mcp-server查看当前参数。 - 3连接
在客户端登记 stdio 命令，凭证通过环境变量或安全输入提供。
- 4开始使用
连接后只列出数据库和集合，确认范围正确。
安装命令
添加 MongoDB MCP Server
codex mcp add mongodb -- npx -y mongodb-mcp-server登记前先按官方 README 准备只读测试账号，并通过安全环境变量提供连接信息。
检查命令
确认 MCP 已经登记
codex mcp list不想自己操作终端时，把下面整段发给 Codex。它会先核对官方说明和前置条件，遇到凭证或占位符会停下来询问。
发给 Codex
自助接入 MongoDB MCP Server
请帮我在当前电脑上接入并验证 MongoDB MCP Server。
官方来源：https://github.com/mongodb-js/mongodb-mcp-server
目标接入命令：codex mcp add mongodb -- npx -y mongodb-mcp-server
请按以下步骤执行：
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 管理权限
- 查询结果可能含个人或业务数据
- 必须限制数据库、账号角色、返回数量和日志暴露
