MongoDB MCP服务

一个生产就绪、即插即用的MongoDB MCP服务器,安全地向AI代理如Cursor、Claude Desktop和Antigravity暴露MongoDB的CRUD操作。

  • by SurajSwarnkar1001
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 SurajSwarnkar1001/mongodb-mcp-server

使用说明

MongoDB MCP服务器🚀

一个生产就绪、即插即用的模型上下文协议(MCP)服务器,它安全地将MongoDB CRUD操作暴露给AI代理,如 光标, 克劳德桌面版,以及 反重力.

构建为轻量级微服务,您可以将其放入任何工作流中 零本地配置不 .env 需要文件,无需复杂的设置。只需将您的代理指向该文件并提供您的数据库字符串。


✨ 特性

  • 零本地配置: 直接通过AI代理的安全MCP设置注入数据库凭据。
  • 动态收藏: 对执行CRUD操作 任何 动态收集。
  • 严格的安全验证: 内建 Joi 验证可防止NoSQL注入尝试和空过滤器意外擦除。
  • 即插即用STDIO: 专门针对光标和反重力背景执行进行了优化。

⚡ 直接集成(光标/克劳德桌面/反重力)

使用此服务器的最简单方法是直接在您的AI IDE或助手中使用标准 stdio 运输。

1.配置您的代理(光标/反重力/克劳德)

打开AI代理的MCP配置设置(例如。, Cursor > Settings > MCP 或 Antigravity MCP settings).

在下面添加确切的JSON块。更新 MONGODB_URI 环境变量与您的实际连接字符串。您甚至不需要预先安装任何东西; npx 将自动获取并运行它!

{
  "mcpServers": {
    "mongodb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@surajswarnkar1001/mongodb-mcp-server"
      ],
      "env": {
        "MONGODB_URI": "Your mongodb connection string"
      },
      "disabledTools": []
    }
  }
}

注意:如果您使用的是MongoDB Atlas,请将URI替换为您的 mongodb+srv://... 云连接字符串。

3.使用与测试

代理连接后,服务器会自动注册 4个强大的工具 (mongo_read, mongo_insert, mongo_update, mongo_delete).

要测试您的连接是否正常工作,只需将此提示复制并粘贴到您的AI助手中(例如Cursor Chat):

在名为的集合中创建一个虚拟用户文档 test_users 使用“Alice”这个名字,然后读给我听,以验证我的MongoDB MCP连接是否正常工作。"

一旦你确认它正在工作,你可以要求更复杂的操作,比如:

  • “从中获取最后5个注册 users 按日期排序的集合”
  • “在中更新文档 users 电子邮件在哪里test@domain.com'并将角色设置为“admin”
  • “我们正在构建一个新功能。删除 analytics 收藏,让我们重新开始。"

🛠️ 扩展工具

想要添加自定义MongoDB聚合或特定逻辑吗?

  1. 创建 mcp-tools/mongo_custom.js.
  2. 出口 schema 和 handler.
  3. 导入并将其安装到中心 TOOL_REGISTRY 在 mcp-tools/index.js.
  4. 它会自动路由并立即出现在代理发现中!