对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

MongoDB MCP Server Overview

MongoDB MCP 服务器允许您以自然语言从AI客户端与MongoDB数据和部署进行交互。

您可以将MongoDB MCP 服务器与任何MongoDB 部署一起使用,包括MongoDB Atlas、 MongoDB Atlas Local、 MongoDB Community Edition和MongoDB Enterprise Advanced。

MongoDB提供两种 MCP Server部署类型:Local MCP for MongoDB MCP Server(您可以自行运行和管理)和MongoDB Atlas Managed MCP Server( MongoDB在Atlas中为您托管和管理)。要学习;了解更多信息,请参阅什么是MongoDB MCP 服务器?下面。

模型上下文协议 (MCP) 是由 Anthropic 开发的开放标准,用于标准化 LLM 与外部资源和服务的连接和交互。MCP 由具有以下关键组件的客户端-服务器架构组成:

  • MCP 主机:要使用 MCP 的应用程序或环境,例如聊天界面或 IDE。示例,Claude Desktop 或VS Code。

  • MCP 客户端:托管内处理与 MCP 服务器连接的组件。有关支持MCP 的客户端列表,请参阅 MCP 客户端。

  • MCP 服务器:向客户端公开特定功能的程序。示例, MongoDB MCP 服务器。

    MCP 服务器向客户端公开功能的主节点 (primary node in the replica set)方式是通过工具。工具是预定义的可执行函数,启用LLM 能够执行特定操作,例如与MongoDB等外部数据源进行交互。

要学习;了解更多信息,请参阅 MCP 文档。

MongoDB MCP 服务器是我们的官方 MCP 服务器实现,为您的 AI 客户端提供一套可用于与 MongoDB 数据和部署进行交互的工具。这些工具包括各种管理操作,例如管理集群资源、查询和索引等数据库操作,以及通过Performance Advisor进行性能优化。

使用工具的MongoDB MCP Server 工作流程示意图

MongoDB 为 MongoDB MCP 服务器 提供两种部署类型:

  • MongoDB MCP 服务器的本地 MCP:您自行运行 MCP 服务器,并直接管理 AI 代理连接和 MCP 服务器基础设施。

  • MongoDB Atlas 托管 MCP 服务器:MongoDB 在 Atlas 中运行 MCP 服务器,并为您管理 AI 代理连接和 MCP 服务器基础设施。

您可以使用 MongoDB MCP 插件或配置文件设置任何部署类型:

  • 适用于AI客户端的MongoDB MCP 插件:您可以从AI客户端的市场安装MongoDB 。 AI客户端是用于提示AI模型的接口。 MongoDB Atlas Managed MCP Server 的MongoDB MCP 插件为交互式AI客户端提供用户委托的访问权限。

  • 手动配置文件设置:您可以将MongoDB MCP 服务器配置和 OAuth客户端凭证手动添加到AI客户端的配置文件中。此设置路径最适合使用编程代理。编程代理是工作流驱动的自动化代理,无需用户输入或指导即可运行多步骤工作流。

下表对 MongoDB MCP 服务器的本地 MCP 和 MongoDB Atlas 托管 MCP 服务器进行了比较。使用此功能可帮助您选择最适合您需求的部署类型:

适用于 MongoDB MCP 服务器的本地 MCP
MongoDB Atlas 托管 MCP 服务器

主机模型

您自行安装、运行和维护 MongoDB MCP 服务器。您负责服务器升级、连接和凭证轮换。

MongoDB 在 Atlas 中托管、运行和维护 MongoDB MCP 服务器。您无需部署、升级或操作 MCP 服务器基础设施。

支持的数据库部署

自管理(本地部署)和 Atlas(云)

Atlas(云)仅限

访问控制级别

最高可达到集合级别数据平面访问权限

最高可达到项目级数据平面访问

最适合

希望直接、细粒度控制 MongoDB MCP 服务器运行位置及其与 MongoDB 部署连接方式的用户。

使用 Atlas 部署的用户希望 MongoDB 为他们托管和管理服务器。

借助 MongoDB Atlas 托管的 MCP 服务器,MongoDB 将在 Atlas 中托管和管理 MongoDB MCP 服务器,而不再要求您在自己的计算机或基础设施上运行服务器。由于 MongoDB 运行服务器,您无需部署、升级或维护任何 MCP 基础设施,也无需管理与 Atlas 部署的连接的连接字符串、秘密或证书。

MongoDB Atlas 托管的 MCP 服务器提供以下优点:

  • 简化部署访问权限:使用MongoDB MCP 插件连接到MongoDB Atlas Managed MCP Server 时,您可以使用Atlas App Connections 直接访问权限数据库部署,而无需管理服务帐户凭证。

  • 广泛的用户支持:MongoDB Atlas 托管 MCP 服务器支持与交互式 AI 客户端工作的用户和使用程序化代理的用户。

  • 管理员治理控制:包括 AI 客户端的组织级别可选加入和只读执行,以及程序化代理的每配置角色、IP 访问列表和只读设置。

MongoDB MCP 服务器的本地 MCP 是自管理的 MongoDB MCP 服务器路径。您自己运行 MCP 服务器,并手动将其连接到 MongoDB 部署和工具。

如果您希望直接控制 MCP 服务器的运行方式和位置,请使用本地 MCP。为了获得此控制权,您需要承担服务器的托管和维护,包括服务器升级和凭证管理。

当您想将 MongoDB MCP 服务器与本地部署类型一起使用时,也会使用本地 MCP,例如 MongoDB Atlas Local、MongoDB Community Edition 和 MongoDB Enterprise Advanced。

MongoDB MCP 服务器允许您使用自然语言与MongoDB数据和部署交互,从而简化开发者工作流程并更轻松地从AI界面执行复杂任务。示例, MongoDB MCP 服务器支持以下使用案例:

用例(Use Case)
说明
提示示例

数据探索

了解并解释数据库模式和关系。

Show the schema of the 'users' collection and explain the purpose of each field.

数据库操作

创建、读取、更新和删除MongoDB集合中的数据。

Find all users from the past week and update their orders to 'shipped'.

数据库管理

执行管理任务以管理集群、数据库用户等。

Create a new database user for my Atlas cluster with read-only access.

代码生成

描述所需的数据,然后生成相关的MongoDB查询和应用程序代码。

Review the schema for the 'users' collection, then generate a Python script that deletes profiles older than 2 years.

性能优化

分析查询性能并获取索引和模式改进建议。

Show me slow queries from the last 24 hours and suggest indexes to improve performance.

有关MongoDB MCP 服务器中可用的特定工具的列表,请参阅MongoDB MCP 服务器工具。

您可以使用从 AI 客户端市场下载的 MongoDB MCP 插件,或者在 AI 客户端的配置文件中手动配置 MongoDB MCP 服务器来设置适用于 MongoDB MCP 服务器和 MongoDB Atlas 托管 MCP 服务器的 Local MCP。

MongoDB MCP 插件可帮助用户为 AI 客户端提供用户委托的访问权限,以探索 MongoDB 部署。此方法使用 Atlas 应用程序连接,允许您通过与 Atlas 身份绑定的 OAuth 流程授权 AI 客户端访问 Atlas 资源。

此方法无需 MCP 基础设施或凭证进行管理。使用 MongoDB MCP 插件:

  • 您可以在 AI 客户端的市场中找到 MongoDB 作为连接器或插件,并使用 Atlas 应用连接对其进行授权。

  • AI 客户端使用您的 Atlas 身份代表您行事。

  • 令牌刷新是自动的。您无需管理连接字符串、秘密或证书。

  • 您可以随时查看和撤销已连接的 AI 客户端。

要学习;了解更多信息,请参阅Atlas App Connections 概述。

您可以手动将 MongoDB MCP 服务器配置添加到 AI 客户端的配置文件中。这种设置方法对于程序化代理访问特别有用。

您使用的凭证取决于您的部署类型

对于 MongoDB MCP 服务器的本地 MCP,您可以添加自己的凭证以连接到 MongoDB 部署,包括集群连接字符串和 Atlas 工具的可选 Atlas API 凭证。

对于 MongoDB Atlas 托管 MCP 服务器,Atlas Organization Owner 或 Project Owner 通过 Atlas 创建 MongoDB Atlas 托管 MCP 服务器配置。此配置:

  • 预配置服务账户,并返回客户端 ID、客户端密钥和您提供给代理的 MongoDB Atlas 托管 MCP 服务器 URL (https://mcp.mongodb.com)。

  • 使用独立的入口和出口 Atlas 服务账户。AI 客户端收到入口凭证,这些凭证仅授予对 MongoDB Atlas 托管 MCP 服务器的访问权限。然后,服务器使用配置了所需 Atlas 权限的独立出口服务账户,代表 AI 客户端进行 API 调用。出口凭证不会暴露给 AI 客户端。

  • 使用服务账户验证 AI 客户端,并使用管理员分配的角色,而不是个人用户的身份。

管理员可以对 MongoDB Atlas Managed MCP Server 进行粒度细化的每配置控制,包括:

  • 授予的 Atlas 角色

  • IP 访问列表

  • 只读标志(默认启用)

某些AI客户端本身并不支持MongoDB Atlas托管 MCP 服务器用于编程访问权限的 MCP 配置服务帐户 OAuth 客户端档案流。要连接这些客户端,请使用 mongodb-atlas-mcp-remote npm包。您可以在客户端的配置文件中使用 npx运行此包。该包从您的 MCP 配置服务帐户凭证获取访问权限令牌,并将请求转发到MongoDB Atlas托管 MCP 服务器,为您处理令牌缓存和刷新。这样,您就可以将AI客户端无缝连接到MongoDB Atlas托管 MCP 服务器。

仅将此包用于通过配置文件连接的 AI 客户端。“开始使用 MongoDB MCP 服务器”页面上的客户端特定说明已使用了该包。

如果您使用LangChain等AI框架构建程序化代理,请勿使用此包。请改为获取访问令牌,然后直接从应用程序代码调用MongoDB Atlas托管的MCP服务器。要了解更多信息,请参阅开始使用MongoDB MCP服务器,然后从AI CLIENT下拉菜单中选择AI Framework Clients。

要配置MongoDB MCP Server 并学习;了解如何使用它,请参阅以下资源:

快速开始使用MongoDB MCP Server。

查看配置MongoDB MCP Server 的先决条件。

查看所有可用的配置和连接选项。

查看MongoDB MCP 服务器中的所有可用工具。

测试示例提示与MongoDB MCP Server 一起使用。

了解MongoDB MCP Server 的安全最佳实践。

查看MongoDB MCP 服务器源代码和贡献指南。