MongoDB MCP Server 🚀

基本能力

产品定位

MongoDB MCP Server 是一个用于 MongoDB 数据库集成的 MCP 服务器实现，提供标准化的协议接口，支持对 MongoDB 数据库的全面操作。

核心功能

• 支持完整的 MongoDB CRUD 操作
• 提供与 MongoDB Atlas 的安全连接处理
• 使用异步/等待模式优化性能
• 全面的错误处理机制
• 支持 Docker 部署
• 提供带有类型提示的查询执行

适用场景

• 需要与 MongoDB 数据库进行标准化交互的应用
• 需要高性能和异步处理的数据库操作
• 需要安全连接和错误处理的数据库服务

工具列表

1. ping：快速测试 MongoDB 连接是否正常。
2. list_databases：列出 MongoDB 实例中的所有数据库。
3. find_documents：在集合中查询文档，支持过滤和分页。

常见问题解答

• 如何设置 MongoDB 连接？：通过环境变量 MONGODB_URI 设置 MongoDB 连接字符串。
• 如何指定默认数据库？：通过环境变量 MONGODB_DB 设置默认数据库名称。
• 如何更改 MCP 服务器端口？：通过环境变量 MCP_PORT 设置端口号（默认为 6274）。

使用教程

使用依赖

• Python 环境：确保已安装 uvx。
• Node.js 环境：确保已安装 npx。
• Docker 环境：确保已安装 Docker。

安装教程

使用 uvx (Python)

uvx mongodb-mcp-bridge

# 使用 SSE 传输进行远程连接
uvx mongodb-mcp-bridge --transport=sse

使用 npx (Node.js)

npx mongodb-mcp-bridge

# 使用 SSE 传输进行远程连接
npx mongodb-mcp-bridge --transport=sse

使用 Docker

# 构建 Docker 镜像
docker build -t mongodb-mcp-server .

# 运行容器
docker run -e MONGODB_URI="your_mongodb_uri" -p 6274:6274 mongodb-mcp-server

调试方式

1. 确保环境变量 MONGODB_URI 已正确设置。
2. 启动服务后，访问 MCP Inspector (http://127.0.0.1:6274) 进行调试。
3. 使用 ping 工具测试连接是否正常。
4. 使用 list_databases 和 find_documents 工具验证数据库操作是否正常。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。