快速配置
选择适合您环境的设置。
最后验证: 2026-06-13
验证环境: Node.js 18+，mongodb-mcp-server 使用 stdio（只读模式）
安装命令:
npx -y mongodb-mcp-server --readOnly验证提示词
列出数据库与集合，并描述最大集合的 schema。
成功时应看到
应以只读方式返回数据库、集合，以及推断出的 schema。
常见陷阱与修复
- ⚠️ 注意: 连接字符串格式、Atlas 网络访问，以及 schema 发现。
- 🔑 始终将 API 密钥存储在环境变量中，切勿硬编码在 JSON 中。
- 🛡️ 如果可用，从只读权限开始，以安全地验证连接。
安全检查
- 把 MDB_MCP_CONNECTION_STRING 放在环境变量里，并使用最小权限的只读数据库用户。
- 生产集群保持启用 --readOnly。
常见错误
| 错误 | 原因 | 修复方法 |
|---|---|---|
Authentication failed | MDB_MCP_CONNECTION_STRING 中的凭据有误。 | 检查用户名/密码以及数据库用户角色。 |
Connection timed out | Atlas IP 访问列表拦截了你的地址。 | 在 Atlas Network Access 添加你的 IP 后重试。 |
Write blocked | --readOnly 默认禁止写操作。 | 仅在安全的非生产环境中才移除 --readOnly。 |
示例提示词
连接后，尝试这些提示词以测试功能：
- 列出数据库中所有集合及其文档数量。
- 查找匹配过滤条件的文档，返回前 10 条结果。
- 显示数据库索引及其用途。