Enables GitHub Copilot to interact with MongoDB databases through the MCP server, allowing natural language queries and operations against MongoDB resources.
Provides tools for interacting with MongoDB Atlas resources and databases, supporting operations like querying, aggregation, document creation/modification, collection management, index creation, and database administration.
用于与 MongoDB 数据库和 MongoDB Atlas 交互的模型上下文协议服务器。
大多数 MCP 客户端需要创建或修改配置文件来添加 MCP 服务器。
您可以通过 args 传递连接字符串，请确保使用有效的用户名和密码。
使用您的 Atlas API 服务帐户凭据。更多详情请参阅Atlas API 访问部分。
或者，您可以在配置文件中使用环境变量或设置它们并通过 npx 运行服务器。
atlas-list-orgs - 列出 MongoDB Atlas 组织atlas-list-projects - 列出 MongoDB Atlas 项目atlas-create-project - 创建一个新的 MongoDB Atlas 项目atlas-list-clusters - 列出 MongoDB Atlas 集群atlas-inspect-cluster - 检查特定的 MongoDB Atlas 集群atlas-create-free-cluster - 创建免费的 MongoDB Atlas 集群atlas-connect-cluster - 连接到 MongoDB Atlas 集群atlas-inspect-access-list - 检查可以访问 MongoDB Atlas 集群的 IP/CIDR 范围atlas-create-access-list - 为 MongoDB Atlas 集群配置 IP/CIDR 访问列表atlas-list-db-users - 列出 MongoDB Atlas 数据库用户atlas-create-db-user - 列出 MongoDB Atlas 数据库用户注意：只有在配置部分设置凭据时，Atlas 工具才可用。
connect - 连接到 MongoDB 实例find - 对 MongoDB 集合运行查找查询aggregate - 针对 MongoDB 集合运行聚合count获取 MongoDB 集合中的文档数量insert-one - 将单个文档插入 MongoDB 集合insert-many - 将多个文档插入 MongoDB 集合create-index - 为 MongoDB 集合创建索引update-one - 更新 MongoDB 集合中的单个文档update-many - 更新 MongoDB 集合中的多个文档rename-collection - 重命名 MongoDB 集合delete-one - 从 MongoDB 集合中删除单个文档delete-many - 从 MongoDB 集合中删除多个文档drop-collection从 MongoDB 数据库中删除一个集合drop-database删除 MongoDB 数据库list-databases - 列出 MongoDB 连接的所有数据库list-collections - 列出给定数据库的所有集合collection-indexes - 描述集合的索引collection-schema - 描述集合的模式collection-storage-size - 获取集合的大小（以 MB 为单位）db-stats - 返回有关 MongoDB 数据库的统计信息MongoDB MCP 服务器可以使用多种方法进行配置，其优先级如下（从高到低）：
| 选项 | 描述 |
|---|---|
apiClientId | 用于身份验证的 Atlas API 客户端 ID |
apiClientSecret | 用于身份验证的 Atlas API 客户端密钥 |
connectionString | MongoDB 连接字符串用于直接数据库连接（可选用户可以选择在每次工具调用时通知它） |
logPath | 存储日志的文件夹 |
disabledTools | 将被禁用的工具名称、操作类型和/或工具类别的数组 |
readOnly | 设置为 true 时，仅允许读取和元数据操作类型，禁用创建/更新/删除操作 |
telemetry | 设置为禁用时，禁用遥测收集 |
默认日志位置如下：
%LOCALAPPDATA%\mongodb\mongodb-mcp\.app-logs~/.mongodb/mongodb-mcp/.app-logs您可以使用disabledTools选项禁用特定工具或特定类别的工具。此选项接受一个字符串数组，其中每个字符串可以是工具名称、操作类型或类别。
数组的构造方式取决于您使用的配置方法的类型：
export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema" 。--disabledTools create update delete atlas collectionSchema 。工具类别：
atlas - MongoDB Atlas 工具，例如列出集群、创建集群等。mongodb - MongoDB 数据库工具，例如 find、aggregate 等。操作类型：
create - 创建资源的工具，例如创建集群、插入文档等。update - 更新资源的工具，例如更新文档、重命名集合等。delete - 删除资源的工具，例如删除文档、删除集合等。read - 读取资源的工具，例如查找、聚合、列出集群等。metadata ——读取元数据的工具，例如列表数据库、列表集合、集合模式等。readOnly配置选项允许您限制 MCP 服务器仅使用具有“读取”和“元数据”操作类型的工具。启用后，所有具有“创建”、“更新”或“删除”操作类型的工具都不会注册到服务器。
这对于您想要提供对 MongoDB 数据的访问以进行分析而又不允许对数据或基础设施进行任何修改的情况很有用。
您可以使用以下方式启用只读模式：
export MDB_MCP_READ_ONLY=true--readOnly当只读模式处于活动状态时，您将在服务器日志中看到一条消息，指示由于此限制而导致哪些工具无法注册。
telemetry配置选项允许您禁用遥测收集。启用后，MCP 服务器将收集使用情况数据并将其发送到 MongoDB。
您可以使用以下方式禁用遥测：
export MDB_MCP_TELEMETRY=disabled--telemetry disabledexport DO_NOT_TRACK=1要使用 Atlas API 工具，您需要在 MongoDB Atlas 中创建一个服务帐户：
要了解有关服务帐户的更多信息，请查看MongoDB Atlas 文档。
apiClientId和apiClientSecret使用前缀MDB_MCP_后跟大写带下划线的选项名称来设置环境变量：
启动服务器时将配置选项作为命令行参数传递：
有兴趣贡献代码吗？太棒了！请查看我们的贡献指南，了解代码贡献指南、标准、添加新工具以及故障排除信息。
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
模型上下文协议服务器，使AI助手能够通过自然语言与MongoDB Atlas资源进行交互，支持数据库操作和Atlas管理功能。