使用说明
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聚合或特定逻辑吗?
- 创建
mcp-tools/mongo_custom.js. - 出口
schema和handler. - 导入并将其安装到中心
TOOL_REGISTRY在mcp-tools/index.js. - 它会自动路由并立即出现在代理发现中!