🗄️ MongoDB MCP Server for LLMS

基本能力

产品定位

MongoDB MCP Server 是一个连接 AI 系统和 MongoDB 数据库的中间件，通过 MCP 协议标准化数据库操作，使 AI 助手能够直接查询和管理数据库。

核心功能

• 集合模式检查：查看数据库中的集合结构
• 文档查询与过滤：支持复杂的查询条件
• 索引管理：创建、删除和查看索引
• 文档操作：插入、更新和删除文档
• 安全访问：通过连接字符串实现安全的数据库访问
• 错误处理：全面的错误验证和处理机制

适用场景

• AI 助手需要查询数据库信息
• 开发人员希望通过自然语言与数据库交互
• 需要快速原型设计和测试数据库查询
• 教育和演示 MongoDB 操作

工具列表

• 查询工具：
• listCollections：列出数据库中的集合
• find：带过滤条件的文档查询
• insertOne：插入单个文档
• updateOne：更新单个文档
• deleteOne：删除单个文档
• 索引工具：
• createIndex：创建新索引
• dropIndex：删除索引
• indexes：列出集合索引

常见问题解答

1. 连接问题：检查连接字符串和网络权限
2. 认证问题：验证用户名/密码和认证数据库
3. 性能问题：添加索引或使用投影限制返回数据
4. 工具执行问题：重启客户端并检查日志

使用教程

使用依赖

• Node.js v18+
• MongoDB 实例
• MCP 客户端（如 Claude Desktop 或 Cursor.ai）

验证 Node.js 版本：

node --version

安装教程

1. 通过 npm 全局安装：

npm install -g @coderay/mongo-mcp-server

1. 或使用 Smithery 安装：

npx -y @smithery/cli install mongo-mcp --client claude

调试方式

1. 开发模式运行：

npm run dev

1. 查看日志（macOS）：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

1. 测试沙盒设置：

docker-compose up -d
npm run seed

许可证

该项目遵循 MIT 开源许可条款。