适合谁
- 开发者和数据分析师希望通过自然语言与 MongoDB 交互
- 需要将 MongoDB 集成到大语言模型工作流的场景
- 使用 MongoDB Atlas 并希望自动化集群管理的团队
M
70FMRS · B
MongoDB 官方维护的 MCP 服务器，功能丰富，覆盖数据库和 Atlas 管理，支持只读模式和安全配置，总体可靠，但需注意安全实践。
MongoDB MCP 服务器是一个由 MongoDB 官方维护的 Model Context Protocol 服务器，用于让 AI 助手通过标准工具与 MongoDB 数据库及 MongoDB Atlas 集群交互。它提供丰富的数据库操作工具（如查询、聚合、索引管理）和 Atlas 管理工具（如集群创建、性能顾问、流处理），并支持只读模式、索引检查、日志记录等安全与运维特性。支持 stdio 与 HTTP 传输，可通过环境变量或命令行参数配置。
工具能力
aggregate
对 MongoDB 集合执行聚合管道
aggregate-db
对 MongoDB 数据库执行聚合管道
collection-indexes
查看集合的索引信息
collection-schema
推断集合的 schema 结构
collection-storage-size
获取集合的存储大小
connect
连接到 MongoDB 实例
count
统计集合中符合条件的文档数量
create-collection
在数据库中创建新集合（数据库不存在会自动创建）
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 知识库中的信息（官方文档、专家指南）
安装接入
- 确保已安装 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"
}
}
}
}
选型与风险
不适合谁
- 不需要数据库交互的通用 MCP 用户
- 需要全面写入权限但不想配置安全措施的用户（默认只读）
- 需要本地存储或非标准传输的用户（仅支持 stdio 和 HTTP）
所需权限
- 网络访问：连接 MongoDB 实例或 Atlas API
- 文件系统访问（可选）：导出数据文件、日志文件
- Atlas API 凭据（使用 Atlas 工具时需要）
风险与副作用
- 如果未启用只读模式，工具可能修改或删除数据库数据
- Atlas API 凭据泄露可能导致集群被未授权管理
- HTTP 传输如果不加认证，可能暴露给未授权客户端
- 服务器端 JavaScript 操作符可能被执行，但默认禁用
常见排障
- 使用 `node -v` 检查 Node 版本是否满足 v22.13.0+
- 检查 MongoDB 连接字符串是否正确，且网络可达
- 确认 Atlas API 凭据有效且具有所需权限
- 查看日志（默认写入磁盘和转发 MCP 客户端），检查错误信息
使用场景
让 AI 助手直接查询和操作 MongoDB 数据库中的数据
管理 MongoDB Atlas 集群、项目、数据库用户和告警
获取性能建议并优化数据库查询
从 MongoDB 官方知识库获取文档和专家指南
支持客户端
Claude Desktop完整支持
VS Code完整支持
Cursor完整支持
Windsurf完整支持
Copilot CLI完整支持
OpenCode完整支持