MongoDB MCP Server
2025.04.05
4
JavaScript数据库服务数据查询数据分析数据库
MongoDB MCP Server 是一个提供对MongoDB数据库只读访问的模型上下文协议服务器。它通过标准化的MCP工具和资源，使AI助手能够直接查询和分析MongoDB数据库，同时保持数据安全性并提供强大的数据探索能力。
View on GitHub
Overview
基本能力
产品定位
MongoDB MCP Server 是一个专门为AI助手设计的MongoDB数据库只读访问服务，旨在提供安全、高效的数据查询和分析能力。
核心功能
MongoDB操作
- 数据库探索：列出数据库和集合
- 模式发现：从样本文档推断集合模式
- 查询：执行带有过滤、投影、排序和限制的MongoDB查询
- 聚合：运行经过安全验证的只读聚合管道
- 文本搜索：在具有文本索引的集合上执行全文搜索
- 地理空间查询：查找靠近点、在多边形内或相交几何体的位置
- 文档操作：计数文档、随机采样文档、按ID查找文档
- 数据分析：获取集合统计信息、索引信息和查询执行计划
- 性能洞察：检查查询执行计划以优化性能
- 数据探索：获取不同的值、字段分布和数据样本
- 格式转换：将查询结果导出为JSON或CSV格式
增强功能
- 模式推断：自动从文档中检测数据类型和结构
- 可视化提示：基于结果内容智能建议数据可视化
- 安全验证：防止聚合管道中的写操作
- 示例丰富的文档：每个工具的描述中都包含详细示例
适用场景
- AI助手需要访问MongoDB数据库进行数据分析
- 需要安全地探索MongoDB数据库结构和内容
- 需要执行复杂的查询和聚合操作而不修改数据
- 需要获取数据库统计信息和性能洞察
工具列表
- MongoDB查询工具
- 聚合管道工具
- 文本搜索工具
- 地理空间查询工具
- 数据采样和分析工具
常见问题解答
- 如何确保数据安全？服务器设计为只读访问，并使用具有只读权限的MongoDB用户。
- 如何调试？可以使用MCP Inspector进行调试。
使用教程
使用依赖
- 需要网络访问MongoDB服务器
- 如果MongoDB实例需要，需要认证凭据
- 对目标数据库具有适当的读取权限
安装教程
从源代码构建
安装依赖：
npm install
构建服务器：
npm run build
开发时自动重建：
npm run watch
与Claude Desktop集成
在MacOS上：~/Library/Application Support/Claude/claude_desktop_config.json
在Windows上：%APPDATA%/Claude/claude_desktop_config.json
添加服务器配置：
{
"mcpServers": {
"mongodb": {
"command": "/path/to/mongodb-server/build/index.js",
"env": {
"MONGODB_URI": "mongodb://username:password@hostname:port/database",
"MONGODB_DEFAULT_DATABASE": "your_default_db"
}
}
}
}
与Claude Web集成
通过MCP Chrome扩展为Claude Web添加配置：
{
"mcpServers": {
"mongodb": {
"command": "node",
"args": ["/path/to/mongodb-server/build/index.js"],
"env": {
"MONGODB_URI": "mongodb://username:password@hostname:port/database",
"MONGODB_DEFAULT_DATABASE": "your_default_db"
}
}
}
}
与Claude Code集成
使用以下命令：
cd /path/to/my/project
claude mcp add mongo-server /path/to/mongodb-mcp/build/index.js -e "MONGODB_URI=mongodb://user@password:27017/dbname?authSource=authDbName" -e MONGO_DEFAULT_DATABASE=dbname
调试方式
使用MCP Inspector进行调试：
npm run inspector
Inspector将在浏览器中提供调试工具的URL。