mongodb-js/mongodb-mcp-server

A Model Context Protocol server to connect to MongoDB databases and MongoDB Atlas Clusters.

MongoDB MCP Server – 快速概览

它是什么 – 一个模型上下文协议（MCP）服务器，让AI代理能够与MongoDB数据库（自托管和MongoDB Atlas）通信。它实现了标准协议，使Claude、Cursor、GitHub Copilot、Grok等工具可以发出数据库命令（find、aggregate、create-index等），而无需代理嵌入原始连接逻辑。

为什么重要 – 启用“数据感知”的LLM代理：模型可以向服务器请求数据、运行查询，甚至在Atlas中创建资源，所有这些都通过安全、默认只读的接口进行。

主要功能（如README中所述）

功能	详情
支持的AI客户端集成	为Cursor、VS Code、Claude、Codex、GitHub Copilot CLI、Grok、Gemini提供官方插件。附带两个插件：`mongodb-atlas`（通过OAuth的远程Atlas MCP）和`mongodb`（适用于任何MongoDB部署的本地服务器）。
命令行/Docker部署	使用`npx -y mongodb-mcp-server@latest --readOnly`或通过Docker（`mongodb/mongodb-mcp-server:latest`）在本地运行。环境变量提供MongoDB连接字符串或Atlas服务账户凭据。
默认只读	服务器以`--readOnly`启动以保护数据；移除标志可启用写入。
丰富的工具集	将许多MongoDB操作作为MCP工具暴露（例如`find`、`aggregate`、`create-index`、`atlas-create-cluster`、`atlas-get-performance-advisor`等）。
安全建议	优先使用环境变量存储机密，授予最小Atlas API权限，除非明确需要写入，否则保持服务器为只读模式。
配置灵活性	支持JSON风格的MCP配置文件、命令行参数、环境变量和基于Docker的启动。
HTTP兼容性	单独的库指南描述了自定义HTTP客户端如何与服务器通信（标头、重定向、有效负载限制）。
云部署	提到Azure部署（详情见文档）。

典型工作流程

为您的AI助手安装适当的插件（例如，Claude Marketplace中的mongodb-atlas）。
提供凭据 – MongoDB URI（MDB_MCP_CONNECTION_STRING）或Atlas服务账户客户端ID/密钥（MDB_MCP_API_CLIENT_ID / MDB_MCP_API_CLIENT_SECRET）。
启动服务器 – 通过npx或Docker。服务器作为子进程运行，AI客户端使用MCP协议与之通信。
发出命令 – 代理可以调用find、aggregate-db、atlas-create-cluster等工具，并接收结构化的JSON结果。
可选写入访问 – 如果代理需要修改数据，请在确认安全策略后移除--readOnly。

谁可能使用此功能？

构建AI增强型应用程序的开发人员 – 需要获取或操作MongoDB中存储的数据。
数据科学团队 – 希望LLM安全地探索他们的MongoDB数据集。
运维团队 – 让AI代理通过atlas-*工具配置或检查Atlas集群。

入门（快速命令）

# 快速本地启动（只读）
npx -y mongodb-mcp-server@latest setup   # 交互式向导
# 或直接运行
npx -y mongodb-mcp-server@latest --readOnly

# Docker替代方案
docker run --rm -i -e MDB_MCP_CONNECTION_STRING='mongodb://localhost:27017/myDb' \
    -e MDB_MCP_READ_ONLY='true' mongodb/mongodb-mcp-server:latest

了解更多

完整文档：https://www.mongodb.com/docs/mcp-server/
插件市场：Cursor、Claude、GitHub Copilot、Grok、Gemini。
自定义HTTP客户端库指南：MCP_SERVER_LIBRARY.md。

以上所有信息均直接来自存储库的README；未推断任何附加功能。