MongoDB MCP Server
2025.05.09
0
TypeScript数据库管理云服务管理数据库
MongoDB MCP Server 是一个基于 Model Context Protocol 的服务器，用于与 MongoDB 数据库和 MongoDB Atlas 进行交互。它提供了丰富的工具集，支持对 MongoDB 数据库和 Atlas 云服务进行各种操作，包括查询、管理、监控等。
View on GitHub
Overview
基本能力
产品定位
MongoDB MCP Server 是一个中间件服务，旨在为开发者提供便捷的 MongoDB 数据库和 Atlas 云服务操作接口，支持通过多种配置方式进行灵活部署和使用。
核心功能
- MongoDB Atlas 工具集：
- 管理 Atlas 组织、项目、集群
- 创建和管理数据库用户
- 配置访问控制列表
-
检查和连接集群
-
MongoDB 数据库工具集：
- 数据库连接管理
- 文档查询（find, aggregate）
- 文档操作（insert, update, delete）
- 集合和数据库管理（rename, drop）
-
元数据查询（list, schema, stats）
-
配置选项：
- 多种配置方式（命令行参数、环境变量）
- 只读模式设置
- 工具禁用控制
- 日志路径配置
适用场景
- 开发环境中快速操作 MongoDB 数据库
- 自动化管理 MongoDB Atlas 资源
- 构建基于 MongoDB 的自动化工具链
- 为 IDE 插件提供 MongoDB 操作能力
工具列表
MongoDB Atlas 工具
atlas-list-orgs- 列出 Atlas 组织atlas-list-projects- 列出 Atlas 项目atlas-create-project- 创建新项目atlas-list-clusters- 列出集群atlas-inspect-cluster- 检查集群atlas-create-free-cluster- 创建免费集群atlas-connect-cluster- 连接集群atlas-inspect-access-list- 检查访问列表atlas-create-access-list- 创建访问列表atlas-list-db-users- 列出数据库用户atlas-create-db-user- 创建数据库用户
MongoDB 数据库工具
connect- 连接数据库find- 查询文档aggregate- 聚合查询count- 计数insert-one- 插入单文档insert-many- 插入多文档create-index- 创建索引update-one- 更新单文档update-many- 更新多文档rename-collection- 重命名集合delete-one- 删除单文档delete-many- 删除多文档drop-collection- 删除集合drop-database- 删除数据库list-databases- 列出数据库list-collections- 列出集合collection-indexes- 集合索引collection-schema- 集合模式collection-storage-size- 集合存储大小db-stats- 数据库统计
常见问题
- 认证问题：必须配置有效的 MongoDB 连接字符串或 Atlas API 凭证
- 工具不可用：某些 Atlas 工具需要特定权限
- 配置优先级：命令行参数 > 环境变量
- 只读模式：可以限制为只读操作
使用教程
使用依赖
- Node.js (v20 或更高版本)
node -v
安装教程
- 通过 npx 直接运行：
npx -y mongodb-mcp-server --apiClientId="your-client-id" --apiClientSecret="your-client-secret"
- 通过配置文件运行：
{
"mcpServers": {
"MongoDB": {
"command": "npx",
"args": [
"-y",
"mongodb-mcp-server",
"--connectionString",
"mongodb+srv://user:[email protected]/db"
]
}
}
}
- 通过环境变量配置：
export MDB_MCP_API_CLIENT_ID="your-client-id"
export MDB_MCP_API_CLIENT_SECRET="your-client-secret"
npx -y mongodb-mcp-server
调试方式
- 检查服务是否运行
- 验证工具是否注册
- 查看日志文件（默认位置）：
- Windows:
%LOCALAPPDATA%\mongodb\mongodb-mcp\.app-logs - macOS/Linux:
~/.mongodb/mongodb-mcp/.app-logs - 测试基本命令：
# 列出数据库
npx mongodb-mcp-server --connectionString="..." list-databases