MongoDB 官方 MCP 服务器让你在对话里直接查集合、看索引、读聚合结果,不用再切到 Compass 或 shell。

排查一个线上问题,经常要在数据库客户端里来回切:看文档结构、跑一条聚合、确认索引到底建没建。MongoDB 官方维护的这个 MCP 服务器把这些动作变成对话。它支持本地实例与 Atlas 集群,也能接 Atlas 管理 API。

基本信息

项目内容
连接器名称MongoDB MCP Server(mongodb-mcp-server)
传输方式stdio
适用客户端VS Code(一键安装)、Claude Desktop、Cursor 等支持 MCP 的客户端
配置示例(json)见下方代码块
仓库地址https://github.com/mongodb-js/mongodb-mcp-server
{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017/myDatabase"
      }
    }
  }
}

核心能力

自然语言查数据。 “上周注册但没下单的用户有多少个”这种问题,它会自己拼查询(find / aggregate)并返回结果。对不熟悉聚合管道语法的人,省掉一大段查文档时间。

结构与索引可读。 能列出数据库、集合、字段分布与索引情况。调优时先看它拉出来的索引清单,比在 shell 里敲 db.coll.getIndexes() 直观。

支持 Atlas 管理能力。 除了直连数据库,它还能用 Atlas 服务账号接管理 API(MDB_MCP_API_CLIENT_ID / MDB_MCP_API_CLIENT_SECRET),做集群层面的查询与操作。对运维场景很有用。

自带交互式安装。 npx -y mongodb-mcp-server@latest setup 会引导你填连接串或 Atlas 凭据,并帮你写配置。比手动拼 json 少出错。

关键的安全设计:只读开关。 官方强烈建议用环境变量传连接串,而不是命令行参数(后者会出现在进程列表里)。另外提供 --readOnly 模式,适合“只让它查、不让它改”的生产库。

使用上手

  1. 先装 Node.js,确认 npx 可用。
  2. 跑 npx -y mongodb-mcp-server@latest setup,按提示填连接串。
  3. 生产库务必加 --readOnly,先别给它写权限。
  4. 连接串一定放环境变量(MDB_MCP_CONNECTION_STRING),不要写进 args。
  5. 让 Agent 先列集合与字段,确认它连的是对的库(这种错很常见)。
  6. 再提问:先问“这个集合有哪些索引”,再问业务问题。
  7. 要接 Atlas 管理能力时,单独建一个只含必要权限的服务账号。

优点与不足

优点是真的官方维护(不是第三方包装),跟进得快;支持本地与 Atlas 两条路;stdio 本地跑,数据不经过第三方;只读模式与环境变量传参这两个安全细节做得到位。不足是 MCP 客户端对长返回值的截断会导致大结果集看不全;复杂聚合仍需你自己能看懂它写的管道;对 MySQL/Postgres 无效(要另找对应连接器)。

适合谁

适合后端开发者排查数据问题;适合数据分析师不熟聚合语法但想自助查数;适合运维用自然语言做数据库巡检。不适合需要精细控制事务与写入顺序的场景。

下载与访问

仓库:https://github.com/mongodb-js/mongodb-mcp-server
文档:https://www.mongodb.com/docs/mcp-server/

许可证与获取

项目说明
安装npx -y mongodb-mcp-server@latest,或跑 setup 子命令引导配置
依赖Node.js;一个 MongoDB 实例或 Atlas 集群
许可证Apache-2.0
星标以 GitHub 为准(公开数据约 1.1k,仅作参考)

生产环境建议先用测试库跑通,再换生产库并保持只读。

本文属于「连接器」分类的 AI 资源专栏,更多评测见分类页。