MongoDB MCP Server

一个提供通过标准化 MCP 工具和资源对 MongoDB 数据库只读访问的模型上下文协议服务器。

Overview

这个 MongoDB MCP 服务器使 AI 助手能够直接查询和分析 MongoDB 数据库而无需写入权限，在保持数据安全的同时提供强大的数据探索能力。

Features

MongoDB Operations

• Database Exploration: 列出数据库和集合
• Schema Discovery: 从示例文档推断集合模式
• Querying: 执行 MongoDB 查询，支持过滤、投影、排序和限制
• Aggregation: 运行只读聚合管道，进行安全验证
• Text Search: 对带有文本索引的集合执行全文搜索
• Geospatial Queries: 查找靠近点、在多边形内或与几何图形相交的位置
• Document Operations: 统计文档数量，采样随机文档，通过 ID 查找文档
• Data Analysis: 获取集合统计信息、索引信息和查询执行计划
• Performance Insights: 检查查询执行计划以优化性能
• Data Exploration: 获取不同的值、字段分布和数据样本
• Format Conversion: 将查询结果导出为 JSON 或 CSV 格式

Enhanced Capabilities

• Schema Inference: 自动检测文档中的数据类型和结构
• Visualization Hints: 根据结果内容提供智能的数据可视化建议
• Safety Validation: 防止在聚合管道中的写入操作
• Example-Rich Documentation: 每个工具在其描述中包含详细示例

Requirements

Environment Variables

• MONGODB_URI (required): MongoDB 连接字符串，如果需要则带有身份验证
• MONGODB_DEFAULT_DATABASE (optional): 查询中未指定时使用的默认数据库名称

Prerequisites

• 网络访问 MongoDB 服务器
• 如果 MongoDB 实例需要，则需要身份验证凭据
• 目标数据库上的适当只读权限

Installation

Building from Source

安装依赖项：

npm install

构建服务器：

npm run build

用于开发，并自动重建：

npm run watch

Integration with 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"
      }
    }
  }
}

Integration with 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"
      }
    }
  }
}

Integration with Claude Code

要与 Claude Code 集成，请将配置添加到 Cline MCP 设置：

{
  "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"
      }
    }
  }
}

Security Considerations

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

Debugging

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。使用 MCP Inspector，它作为包脚本可用：

npm run inspector

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