Mongo Db MCP Server

📢 COMMUNITY SERVER NOTICE

This is a community-maintained MCP Server.

👉 For the official MongoDB MCP Server, visit mongodb-js/mongodb-mcp-server

MongoDB MCP服务器

一个模型上下文协议服务器，提供对MongoDB数据库的只读访问。此服务器使LLM能够检查收集模式并执行聚合管道。

组件

工具

• 合计

- 对连接的数据库执行MongoDB聚合管道 - 输入： - collection （string）：要查询的集合 - pipeline （数组）：MongoDB聚合管道阶段 - options （对象）：可选聚合设置 - allowDiskUse （boolean）：允许需要磁盘使用的操作 - maxTimeMS （number）：最大执行时间（毫秒） - comment （string）：用于标识操作的注释 - 如果未指定限制阶段，则默认限制为1000个文档 - 默认超时30秒

• 解释

- 获取聚合管道的执行计划 - 输入： - collection （string）：要分析的集合 - pipeline （数组）：MongoDB聚合管道阶段 - verbosity （string）：解释的详细程度 - 选项：“queryPlanner”、“executionStats”、“allPlansExecution” - 默认值：“queryPlanner”

资源

服务器为数据库中的每个集合提供架构信息：

• 集合架构 (mongodb:////schema)

- 每个集合的推断JSON模式信息 - 包括字段名和数据类型 - 模式来源于采样收集文档

使用Claude Desktop

要将此服务器与Claude Desktop应用程序一起使用，请将以下配置添加到您的“mcpServers”部分 claude_desktop_config.json:

"mongodb": {
      "command": "npx",
      "args": [
        "-y" ,
        "@pash1986/mcp-server-mongodb"
      ],
     "env" : {
	"MONGODB_URI" : "mongodb+srv://" // 'mongodb://localhost:27017'
	}
    }

替换 mydb 使用您的数据库名称，并根据需要调整连接字符串。

示例用法

基本聚合

{
  "collection": "users",
  "pipeline": [
    { "$match": { "age": { "$gt": 21 } } },
    { "$group": {
      "_id": "$city",
      "avgAge": { "$avg": "$age" },
      "count": { "$sum": 1 }
    }},
    { "$sort": { "count": -1 } },
    { "$limit": 10 }
  ],
  "options": {
    "allowDiskUse": true,
    "maxTimeMS": 60000,
    "comment": "City-wise user statistics"
  }
}

查询说明

{
  "collection": "users",
  "pipeline": [
    { "$match": { "age": { "$gt": 21 } } },
    { "$sort": { "age": 1 } }
  ],
  "verbosity": "executionStats"
}

安全功能

• 如果管道中没有指定限制，则自动限制1000份文件
• 所有操作的默认超时为30秒
• 只读操作
• 从集合样本中安全推断模式

许可证

此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。