MCP MongoDB 服务器

---

一个模型上下文协议服务器，提供对 MongoDB 数据库的访问。该服务器使 LLM 能够检查集合模式并执行 MongoDB 操作。

演示

功能

只读模式

• 使用 --read-only 或 -r 标志以只读模式连接到 MongoDB
• 阻止写入操作（更新、插入、创建索引）
• 使用 MongoDB 的辅助读取偏好以获得最佳读取性能
• 为生产数据库连接提供额外的安全性

资源

• 通过 mongodb:// URI 列出和访问集合
• 每个集合都有一个名称、描述和模式
• 用于模式访问的 JSON mime 类型

工具

• query

  • 执行 MongoDB 查询，并可选择执行计划分析
  • 输入：集合名称、过滤器、投影、限制、explain 选项
  • 返回查询结果或执行计划

• aggregate

  • 执行 MongoDB 聚合管道，并可选择执行计划分析
  • 输入：集合名称、管道阶段、explain 选项
  • 返回聚合结果或执行计划

• update

  • 更新集合中的文档
  • 输入：集合名称、过滤器、更新操作、upsert/multi 选项
  • 返回更新操作结果

• serverInfo

  • 获取 MongoDB 服务器信息和状态
  • 输入：可选的调试信息标志
  • 返回版本、存储引擎和服务器详细信息

• insert

  • 将文档插入到集合中
  • 输入：集合名称、文档数组、写入选项
  • 返回插入操作结果

• createIndex

  • 在集合上创建索引
  • 输入：集合名称、索引规范、写入选项
  • 返回索引创建结果

• count

  • 统计与查询匹配的文档
  • 输入：集合名称、查询过滤器、计数选项
  • 返回文档计数

提示

• analyze_collection - 分析集合结构和内容
  • 输入：集合名称
  • 输出：关于模式、数据类型和统计信息的见解

开发

安装依赖项：

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": "node",
      "args": [
        "~/mcp-mongo-server/build/index.js",
        "mongodb://muhammed:kilic@mongodb.localhost/namespace"
      ]
    },
    "mongodb-readonly": {
      "command": "node",
      "args": [
        "~/mcp-mongo-server/build/index.js",
        "mongodb://muhammed:kilic@mongodb.localhost/namespace",
        "--read-only"
      ]
    }
  }
}

调试

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

npm run inspector

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

组件

资源

服务器提供数据库中每个集合的模式信息：

• 集合模式 (mongodb://<host>/<collection>/schema)
  • 每个集合的 JSON 模式信息
  • 包括字段名称和数据类型
  • 自动从集合文档中推断

与 Claude Desktop 一起使用

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

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://muhammed:kilic@mongodb.localhost/sample_namespace"
      ]
    },
    "mongodb-readonly": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://muhammed:kilic@mongodb.localhost/sample_namespace",
        "--read-only"
      ]
    },
    "mongodb-github": {
      "command": "npx",
      "args": [
        "-y",
        "github:kiliczsh/mcp-mongo-server",
        "mongodb://muhammed:kilic@mongodb.localhost/sample_namespace",
        "--read-only"
      ]
    }
  }
}

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 MCP MongoDB Server：

npx -y @smithery/cli install mcp-mongo-server --client claude

通过 mcp-get 安装

您可以使用 mcp-get 安装此软件包：

npx @michaellatman/mcp-get@latest install mcp-mongo-server

将 /sample_namespace 替换为您的数据库名称。

使用只读模式

您可以通过在启动服务器时添加 --read-only 或 -r 标志以只读模式连接到 MongoDB。 当您需要保护您的数据免受意外写入或连接到生产数据库时，建议这样做。

# 使用命令行以只读模式连接
npx mcp-mongo-server mongodb://user:password@mongodb.example.com/database --read-only

在只读模式下：

1. 所有写入操作（更新、插入、创建索引）将被阻止
2. 服务器使用 MongoDB 的辅助读取偏好进行连接
3. 连接状态指示只读模式处于活动状态
4. ping 和 serverInfo 响应包括只读状态信息

许可证

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