MongoDB MCP 服务器

这是一个通过标准化的MCP工具和资源提供对MongoDB数据库只读访问的Model Context Protocol服务器。

<a href="https://glama.ai/mcp/servers/cmywezu1sn"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=36339755,3906051027&fm=3081&app=3081&f=PNG?w=760&h=400" alt="MongoDB Server MCP 服务器" /> </a>

概述

此MongoDB MCP服务器允许AI助手直接查询和分析MongoDB数据库，同时不具有写入权限，从而在保证数据安全的同时提供了强大的数据分析能力。

特性

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时应看到如下内容：

╭───────────────────────────────────────────────────────╮
│ ✻ 欢迎使用Claude Code研究预览！                      │
│                                                       │
│   /help 获取帮助                                      │
│                                                       │
│   当前工作目录：<项目目录路径>                         │
│                                                       │
│   ─────────────────────────────────────────────────── │
│                                                       │
│   MCP 服务器：                                        │
│                                                       │
│   • mongo-server                            已连接   │
╰───────────────────────────────────────────────────────╯

如果遇到问题，请参阅Claude Code 文档。

安全注意事项

• 此服务器设计为只读访问
• 连接字符串可能包含敏感的身份验证信息
• 将连接字符串安全地存储在环境变量中
• 使用具有只读权限的MongoDB用户

调试

由于MCP服务器通过标准I/O通信，调试可能会很困难。可以使用MCP Inspector，它作为包脚本提供：

npm run inspector

Inspector将提供一个URL，以便您可以在浏览器中访问调试工具。