← 返回目录

MongoDB MCP Server

官方

连接 MongoDB 数据库与 Atlas 集群的官方 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 数据库第 8 / 58
Stars: ★ 1.1k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 22.13+ · Docker
凭据: 可选 API Key
许可证: Apache-2.0
最近提交: 今天
工具数: 52

70FMRS · B

MongoDB 官方维护的 MCP 服务器，功能丰富，覆盖数据库和 Atlas 管理，支持只读模式和安全配置，总体可靠，但需注意安全实践。

最强项 · 文档质量 16/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

16/20

维护活跃度

14/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: 清单和 README 展示了完整的工具集、配置项和 transports，正常启动路径看似合理；但本次静态评审未提供任何测试文件、CI 工作流或可执行证据，无法确认 init/工具列表握手及错误路径，因此不给超过 12 分，按“快乐路径可行但验证薄弱”取 10 分。
安全与权限 16/20: 清单将连接字符串、API 客户端凭据、Voyage key 标记为 secret；README 明确建议用环境变量而非命令行参数、推荐最小权限服务账号、默认示例使用 --readOnly、危险工具有确认机制、HTTP 传输有安全警告，且默认 connectionScope=session 和 disableServerSideJs=true。未发现红线问题；但缺少源码验证这些控制确实生效，故扣分，给 16 分。
维护活跃度 14/20: 仓库未归档，采用 Apache-2.0 许可证，由 mongodb-js 组织维护，并发布 2.0.0 的 npm 与 OCI 包，版本管理清晰；但提供的材料中没有提交历史、发布时间线、issue 响应或依赖更新记录，无法确认持续维护节奏，故给 14 分。
文档质量 16/20: README 覆盖安装前置条件、多种启动方式（npx/Docker/HTTP/Copilot/OpenCode）、认证、完整配置表、工具列表、资源、只读/索引检查/导出/日志等限制与安全建议，层次清晰。扣分原因是缺少独立故障排查章节和逐工具参数文档，成本信息也未涉及，故给 16 分。
安装易用性 14/20: 安装路径清晰：只需 Node 22.13+ 或 Docker，README 给出 npx、Docker、HTTP、Copilot、OpenCode 以及 VS Code/Cursor 安装链接和配置示例，步骤少且覆盖主流客户端。由于静态校准要求超过 15 分必须有可执行证据，而本次没有 CI/测试证据，故给 14 分。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

开发者和数据分析师希望通过自然语言与 MongoDB 交互
需要将 MongoDB 集成到大语言模型工作流的场景
使用 MongoDB Atlas 并希望自动化集群管理的团队

不适合谁

不需要数据库交互的通用 MCP 用户
需要全面写入权限但不想配置安全措施的用户（默认只读）
需要本地存储或非标准传输的用户（仅支持 stdio 和 HTTP）

所需权限

网络访问：连接 MongoDB 实例或 Atlas API
文件系统访问（可选）：导出数据文件、日志文件
Atlas API 凭据（使用 Atlas 工具时需要）

风险与副作用

如果未启用只读模式，工具可能修改或删除数据库数据
Atlas API 凭据泄露可能导致集群被未授权管理
HTTP 传输如果不加认证，可能暴露给未授权客户端
服务器端 JavaScript 操作符可能被执行，但默认禁用

安装接入

准备工作

运行环境：Node.js 22.13+ · Docker

MDB_MCP_CONNECTION_STRING 可选密钥 MongoDB 连接字符串，格式如 mongodb://localhost:27017/myDatabase，指向本地或 Atlas 实例。

MDB_MCP_API_CLIENT_ID 可选密钥 Atlas Service Account 的 API client ID，需在 MongoDB Atlas 控制台创建服务账户获取。

MDB_MCP_API_CLIENT_SECRET 可选密钥 Atlas Service Account 的 API 密钥，与 client ID 配对使用，仅 Atlas 工具需要。

MDB_MCP_VOYAGE_API_KEY 可选密钥 Voyage AI 嵌入服务密钥，仅在创建带自动向量搜索的 Atlas Local 部署时需要。

其他可选配置项（1 个）

MDB_MCP_READ_ONLY 可选设为 true 时只允许读、连接和元数据操作，禁用写入和删除。

确保已安装 Node.js v22.13.0 或更高版本（node -v 检查）。
在 MCP 客户端配置文件中添加服务器定义，例如：

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017/myDatabase"
      }
    }
  }
}

如使用 Atlas 工具，需配置 Atlas API 客户端 ID 和密钥（通过环境变量或参数）。
如需使用 Docker，可运行 docker run --rm -i mongodb/mongodb-mcp-server:latest。
如需 HTTP 传输，使用 --transport http 参数。

claude_desktop_config.json

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server@latest",
        "--readOnly"
      ],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017/myDatabase"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server@latest",
        "--readOnly"
      ],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017/myDatabase"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add MongoDB -e MDB_MCP_CONNECTION_STRING=mongodb://localhost:27017/myDatabase -- npx -y mongodb-mcp-server@latest --readOnly

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端的工具列表中应出现 find、list-databases 等工具；让 AI 执行 list-databases，若能返回数据库列表则连接成功。

常见排障

使用 `node -v` 检查 Node 版本是否满足 v22.13.0+
检查 MongoDB 连接字符串是否正确，且网络可达
确认 Atlas API 凭据有效且具有所需权限
查看日志（默认写入磁盘和转发 MCP 客户端），检查错误信息

试试这样问

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

列出本地数据库中的所有集合
查询 orders 集合中最近 10 条记录
为 users 集合的 email 字段创建索引
在 Atlas 上创建一个免费的集群并列出我的项目

工具能力 52

aggregate 只读

对 MongoDB 集合执行聚合管道

aggregate-db 只读

对 MongoDB 数据库执行聚合管道

collection-indexes 只读

查看集合的索引信息

collection-schema 只读

推断集合的 schema 结构

collection-storage-size 只读

获取集合的存储大小

connect 只读

连接到 MongoDB 实例

count 只读

统计集合中符合条件的文档数量

create-collection 写入

在数据库中创建新集合（数据库不存在会自动创建）

展开其余 44 个工具

create-index 写入

为集合创建索引

db-stats 只读

返回单个数据库的使用状态统计

delete-many 破坏性

删除集合中满足过滤条件的所有文档

disconnect 只读

关闭 MongoDB 连接并撤销其 connectionId

drop-collection 破坏性

从数据库中删除集合及其关联索引

drop-database 破坏性

删除指定数据库及其数据文件

drop-index 破坏性

删除指定数据库和集合上的索引

explain 只读

返回查询优化器所选执行计划的统计信息

export 只读

将查询或聚合结果以指定 EJSON 格式导出

find 只读

对 MongoDB 集合执行查询

insert-many 写入

向集合中插入一组文档（可分批）

list-collections 只读

列出指定数据库的所有集合

list-connections 只读

列出当前活动的 MongoDB 连接及其 connectionId

list-databases 只读

列出 MongoDB 连接中的所有数据库

mongodb-logs 只读

返回最近的 mongod 事件日志

rename-collection 写入

重命名 MongoDB 数据库中的集合

update-many 写入

更新集合中满足过滤条件的所有文档

atlas-connect-cluster 只读

连接 MongoDB Atlas 集群并返回 connectionId

atlas-create-access-list 写入

允许 IP/CIDR 范围访问 Atlas 集群

atlas-create-cluster 写入

创建 MongoDB Atlas 集群（M10-M80）

atlas-create-db-user 写入

创建 MongoDB Atlas 数据库用户

atlas-create-free-cluster 写入

创建免费 MongoDB Atlas 集群

atlas-create-project 写入

创建 MongoDB Atlas 项目

atlas-get-performance-advisor 只读

获取 Atlas 性能顾问推荐（索引、慢查询等）

atlas-inspect-access-list 只读

检查允许访问 Atlas 集群的 IP/CIDR 范围

atlas-inspect-cluster 只读

检查 Atlas 集群的元数据

atlas-list-alerts 只读

列出 Atlas 项目触发的告警

atlas-list-clusters 只读

列出 MongoDB Atlas 集群

atlas-list-db-users 只读

列出 MongoDB Atlas 数据库用户

atlas-list-orgs 只读

列出 MongoDB Atlas 组织

atlas-list-projects 只读

列出 MongoDB Atlas 项目

atlas-load-sample-dataset 写入

向 Atlas 集群加载示例数据集

atlas-pause-resume-cluster 写入

暂停或恢复专用 Atlas 集群（M10+）

atlas-streams-build 写入

创建 Atlas Stream Processing 资源（工作区、连接、处理器）

atlas-streams-discover 只读

发现和检查 Atlas Stream Processing 资源

atlas-streams-manage 写入

管理 Atlas Stream Processing 资源（启停、修改）

atlas-streams-teardown 破坏性

删除 Atlas Stream Processing 资源

atlas-upgrade-cluster 写入

升级 Atlas 集群层级（如 M0 到 Flex 或 M10）

atlas-local-connect-deployment 只读

连接本地 Atlas Local 部署并返回 connectionId

atlas-local-create-deployment 写入

创建本地 Atlas Local 部署

atlas-local-delete-deployment 破坏性

删除本地 Atlas Local 部署

atlas-local-list-deployments 只读

列出本地 Atlas Local 部署

list-knowledge-sources 只读

列出 MongoDB Assistant 知识库中的数据源

search-knowledge 只读

搜索 MongoDB Assistant 知识库中的信息（官方文档、专家指南）

使用场景

让 AI 助手直接查询和操作 MongoDB 数据库中的数据

管理 MongoDB Atlas 集群、项目、数据库用户和告警

获取性能建议并优化数据库查询

从 MongoDB 官方知识库获取文档和专家指南

支持客户端

Claude Desktop

VS Code

Cursor

Windsurf

GitHub Copilot CLI

OpenCode

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

详细介绍

MongoDB MCP 服务器是一个由 MongoDB 官方维护的 Model Context Protocol 服务器，用于让 AI 助手通过标准工具与 MongoDB 数据库及 MongoDB Atlas 集群交互。它提供丰富的数据库操作工具（如查询、聚合、索引管理）和 Atlas 管理工具（如集群创建、性能顾问、流处理），并支持只读模式、索引检查、日志记录等安全与运维特性。支持 stdio 与 HTTP 传输，可通过环境变量或命令行参数配置。