MongoDB MCP 服务器工具

MongoDB MCP 服务器允许您使用来自支持MCP的AI客户端的自然语言查询与MongoDB集群进行交互。本页介绍 MCP 服务器工具。

Overview

MongoDB MCP服务器提供以下工具类别：

Atlas工具，对Atlas系统资源（如组织、项目、集群、数据库用户帐户）执行操作并检索性能建议。
本地Atlas工具，允许您列出、连接、创建和删除本地Atlas部署。
数据库工具，执行插入、更新和删除文档以及运行查询和聚合管道等操作。

MCP 服务器Atlas工具

仅当您按照 MongoDB MCP 服务器配置中所示设立Atlas API凭证时， Atlas工具才可用。

下表描述了Atlas工具：

MCP Server Atlas工具名称	说明
`atlas-list-orgs`	返回Atlas组织列表。
`atlas-list-projects`	返回Atlas项目列表。
`atlas-create-project`	创建新的Atlas项目。
`atlas-list-clusters`	返回Atlas集群列表。
`atlas-inspect-cluster`	返回有关特定Atlas 集群的信息。
`atlas-create-free-cluster`	创建一个免费的Atlas 集群。
`atlas-connect-cluster`	使用配置的服务帐户连接到Atlas 集群。如果配置 MCP服务器时未指定连接字符串，则此工具将创建一个具有随机密码的临时数据库用户来建立连接。有关详细信息，请参阅工具详情。
`atlas-inspect-access-list`	返回有关可以访问权限Atlas 集群的IP和CIDR范围的信息。
`atlas-create-access-list`	为Atlas 集群配置IP和CIDR访问权限列表。
`atlas-list-db-users`	返回Atlas数据库用户的列表。
`atlas-create-db-user`	创建Atlas数据库用户。
`atlas-list-alerts`	返回Atlas项目的警报列表。
`atlas-get-performance-advisor`	返回Performance Advisor针对Atlas集群的建议。支持对建议索引、删除索引建议、慢查询日志和模式建议的操作。需要 `Project Read Only` 或更高访问权限。要学习更多信息，请参阅Performance Advisor工具。

MCP 服务器本地Atlas工具

您可以将 MCP 服务器与本地 Atlas 部署一起使用。要将 MCP 服务器工具用于本地Atlas部署，您必须安装Docker。有关本地Atlas部署的介绍，请参阅创建本地Atlas部署。

下表描述了本地Atlas工具：

MCP 服务器本地Atlas工具名称	说明
`atlas-local-list-deployments`	列出本地Atlas部署。
`atlas-local-create-deployment`	创建本地Atlas部署。要运行此工具，必须禁用只读模式。
`atlas-local-connect-deployment`	连接到本地Atlas部署。
`atlas-local-delete-deployment`	删除本地Atlas部署。要运行此工具，必须禁用只读模式。

有关运行本地Atlas工具的示例，请参阅本地Atlas部署。

MCP 服务器Database Tools

下表描述了数据库工具：

MCP 服务器数据库工具名称	说明
`connect`	连接到MongoDB 集群。
`find`	运行MongoDB 数据库查询。
`aggregate`	运行MongoDB聚合管道。
`count`	返回集合中的文档数。
`insert-many`	将文档添加到集合。如果您在 MCP 配置中指定了 Voyage AI API密钥，服务器可以自动从文本生成向量嵌入，并将其包含在插入的文档中。
`create-index`	在集合上创建索引。此工具支持创建向量搜索索引。
`drop-index`	从集合中删除向量搜索索引。
`update-one`	修改集合中的单个文档。
`update-many`	修改集合中的多个文档。
`rename-collection`	更改集合的名称。
`delete-many`	从集合中删除文档。
`drop-collection`	从数据库中删除集合。
`drop-database`	删除数据库。
`list-databases`	返回通过当前连接可用的所有数据库的列表。
`list-collections`	返回数据库中的集合列表。
`collection-indexes`	返回有关集合索引的信息，包括向量搜索索引。
`collection-schema`	返回集合模式信息。
`collection-storage-size`	返回集合大小（以 MB 为单位）。
`db-stats`	返回数据库统计信息。
`export`	将查询或聚合管道的结果以JSON格式保存到运行 MCP 服务器的计算机上的文件中。还可以通过AI客户端应用程序中的 `exported-data`资源访问结果。

工具详情

有关特定 MCP 工具的更多信息，请参阅以下部分。

向量搜索支持

MCP 中的矢量搜索支持可作为预览功能提供。要启用此功能，请在previewFeatures MDB_MCP_PREVIEW_FEATURESsearchMCP 配置中将标志或环境变量设立为。要学习；了解更多信息，请参阅MongoDB MCP 服务器配置选项。

MongoDB MCP Server 支持MongoDB Vector Search。您可以创建和管理向量搜索索引、生成嵌入以及通过自然语言提示运行语义搜索查询。下表总结了主要功能。

用例(Use Case)	示例提示	相关工具
管理索引	`Create a vector search index on the sample_db database and products collection` `Show me all vector search indexes on the products collection` `Drop the vector search index named vector_index`	`create-index` `collection-indexes` `drop-index`
插入具有自动嵌入功能的文档	`Insert these documents into the products collection and embed their descriptions`	`insert-many`
向量搜索查询	`Search for documents semantically similar to this description` `Find me related products filtered by price range`	`aggregate`

使用以下资源学习；了解更多信息：

索引管理

以下工具允许您管理向量搜索索引：

collection-indexes：列出集合上的所有索引，包括向量搜索索引，并提供索引状态信息。
create-index：在集合上创建新的向量搜索索引。
drop-index：从集合中删除向量搜索索引。

注意

要更新向量搜索索引，请删除现有索引并创建新索引。

自动生成嵌入

如果您使用 Voyage AI API密钥配置 MCP 服务器，服务器可以通过以下方式自动生成嵌入：

为文档生成嵌入内容：使用insert-many 工具时在文档中嵌入文本字段。
为查询生成嵌入：使用aggregate 工具运行向量搜索搜索查询时嵌入搜索查询。具体来说，服务器为聚合查询中的queryVector $vectorSearch参数生成嵌入。

MCP 服务器支持以下 Voyage AI嵌入模型：

voyage-3-large
voyage-3.5
voyage-3.5-lite
voyage-code-3

要学习；了解有关 Voyage AI模型的更多信息，请参阅 Voyage AI文档。

注意

默认下， MongoDB MCP Server 会验证具有向量搜索索引的字段是否包含有效的向量嵌入，以防止破坏向量搜索索引。要禁用此行为，请将disableEmbeddingsValidation 选项设立为true 。要学习；了解更多信息，请参阅向量搜索选项。

Considerations

MongoDB MCP 服务器支持预过滤向量搜索查询。要学习；了解更多信息，请参阅MongoDB Vector Search 预过滤。

MCP服务器不支持向量搜索索引的 quantization字段。

Performance Advisor

atlas-get-performance-advisor 工具允许您通过自然语言查询访问Performance Advisor的建议。该工具通过分析慢速查询并提出改进建议，帮助您发现性能优化机会。

执行慢查询分析时， MongoDB MCP 服务器会检索慢查询示例，上限为 50 个查询。该示例最多包含 50 个符合提示中任何指定条件的最新慢速查询，以确保最佳性能和响应时间。

注意

此工具需要 Project Read Only 访问权限或更高权限以及 M10+集群。它可与 --readonly 标志一起使用。

用例(Use Case)	示例提示	Performance Advisor操作
分析慢速查询	`Show me my slow queries` `What is slowing down my cluster?` `Show me queries that are longer than 5 seconds` `Show me slow writes in the website.users namespace`	slowQueryLogs
索引建议	`Are there any indexes I should create to improve performance?` `What indexes do you recommend I drop?`	suggestIndexes 删除索引建议
模式建议	`Show schema recommendations for my cluster` `Help me optimize my database schema`	模式建议

有关详细的使用示例和示例输出，请参阅性能优化。

不使用Atlas连接字符串进行连接

如果配置 MCP服务器时未指定Atlas 集群的连接字符串，则atlas-connect-cluster 工具会创建临时数据库用户，以使用配置的Atlas API服务帐户凭证建立与集群的连接。

临时数据库用户具有以下特征：

随机生成的用户名和密码。
12 小时后自动过期。
根据您配置 MCP 服务器的方式分配的角色：
- readAnyDatabase（如果启用了只读模式或禁用了 create、delete 和 update 工具类别）。
- readWriteAnyDatabase 如果服务器具有完整权限。

注意

MongoDB MCP 服务器仅将用户凭证存储在内存中，从不返回或在 LLM 上下文中公开凭证。

了解详情

要禁用特定工具并将 MCP 服务器限制为只读模式，请参阅MongoDB MCP 服务器配置。

要查看一些 MCP Server 示例自然语言提示，请参阅MongoDB MCP Server 使用示例。

后退

故障排除

来年

安全性