MongoDB MCP 服务器
模型上下文协议服务器，通过标准化的 MCP 工具和资源提供对 MongoDB 数据库的只读访问。
概述
该 MongoDB MCP 服务器使 AI 助手能够直接查询和分析 MongoDB 数据库，而无需写入权限，在提供强大的数据探索功能的同时保证数据安全。
Related MCP server: MongoDB MCP Server for LLMs
特征
MongoDB 操作
数据库探索：列出数据库和集合
模式发现：从样本文档推断集合模式
查询：使用过滤、投影、排序和限制执行 MongoDB 查询
聚合：运行带有安全验证的只读聚合管道
文本搜索：使用文本索引对集合进行全文搜索
地理空间查询：查找点附近、多边形内或相交几何体的位置
文档操作：计数文档、随机抽样文档、通过 ID 查找文档
数据分析：获取集合统计信息、索引信息和查询执行计划
性能洞察：检查查询执行计划以优化性能
数据探索：获取不同的值、字段分布和数据样本
格式转换：将查询结果导出为 JSON 或 CSV 格式
增强功能
模式推断：自动从文档中检测数据类型和结构
可视化提示：根据结果内容进行数据可视化的智能建议
安全验证：防止聚合管道中的写入操作
示例丰富的文档：每个工具在其描述中包含详细的示例
要求
环境变量
MONGODB_URI（必需）：如果需要，带有身份验证的 MongoDB 连接字符串MONGODB_DEFAULT_DATABASE（可选）：查询中未指定时的默认数据库名称
先决条件
通过网络访问 MongoDB 服务器
如果 MongoDB 实例需要，则需要身份验证凭据
对目标数据库的适当读取权限
安装
从源代码构建
安装依赖项：
npm install构建服务器：
npm run build对于使用自动重建的开发：
npm run watch与 Claude Desktop 集成
要与 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，将配置添加到 Cline MCP 设置：
{
"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 集成
要与 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 确保用实际的 MongoDB 连接字符串和默认数据库名称替换占位符。
如果配置正确，运行claude时你应该会看到以下内容：
╭───────────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code research preview! │
│ │
│ /help for help │
│ │
│ cwd: <path-to-project-directory> │
│ │
│ ─────────────────────────────────────────────────── │
│ │
│ MCP Servers: │
│ │
│ • mongo-server connected │
╰───────────────────────────────────────────────────────╯
如果遇到问题，请参阅 Claude 代码文档。
安全注意事项
该服务器设计提供只读访问权限
连接字符串可能包含敏感的身份验证信息
将连接字符串安全地存储在环境变量中
使用具有只读权限的 MongoDB 用户
调试
由于 MCP 服务器通过 stdio 进行通信，调试起来可能比较困难。您可以使用MCP Inspector 工具，它包含在包脚本中：
npm run inspector检查器将提供一个 URL 来访问浏览器中的调试工具。