MongoDB MCP 服务器工具

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

Overview

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

仅当您按照 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-list-performance-advisor`	返回针对Atlas 集群的 Performance `Project Read Only` Advisor建议。支持对建议索引、删除索引建议、慢查询日志和模式建议的操作。需要或更高访问权限。要学习；了解更多信息，请参阅Performance Advisor工具。

您可以将 MCP Server 与本地Atlas部署一起使用。有关本地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部署。要运行此工具，必须禁用只读模式。

下表描述了数据库工具：

MCP 服务器数据库工具名称	说明
`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`	返回集合大小（以 MB 为单位）。
`db-stats`	返回数据库统计信息。
`export`	将查询或聚合管道的结果以JSON格式保存到运行 MCP 服务器的计算机上的文件中。还可以通过AI客户端应用程序中的 `exported-data`资源访问结果。

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

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

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

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

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

atlas-list-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 dropIndexRecommendations
模式建议	`Show schema recommendations for my cluster` `Help me optimize my database schema`	schemaAdvice

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

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

后退

故障排除

来年

安全性