Mongodb MCP

🚀 🗄️ MongoDB MCP 服务器用于LLM

MongoDB MCP服务器是一个模型上下文协议（MCP）服务器，它能让大语言模型（LLM）直接与MongoDB数据库交互。用户可通过自然语言查询集合、检查模式以及管理数据，极大提升了操作的便捷性。

✨ 主要特性

• 🔍 集合架构检查：可轻松查看集合的架构信息。
• 📊 文档查询和筛选：支持对文档进行灵活的查询与筛选操作。
• 📈 索引管理：方便对数据库索引进行管理。
• 📝 文档操作（插入、更新、删除）：能直接对文档执行插入、更新和删除等操作。

🎥 演示视频

点击查看演示视频

🚀 快速开始

配置连接信息

要开始使用，您需要找到MongoDB连接URL，并将其添加到Claude Desktop配置文件中：

• MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

配置示例如下：

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "mongo-mcp",
        "mongodb://<username>:<password>@<host>:<port>/<database>?authSource=admin"
      ]
    }
  }
}

通过Smithery安装

您可以通过Smithery自动安装MongoDB MCP服务器，用于Claude Desktop，命令如下：

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

先决条件

• Node.js 18+
• npx
• Docker和Docker Compose（仅限本地沙盒测试）
• MCP客户端（例如Claude Desktop App）

测试沙盒设置

如果您没有可用的MongoDB服务器，并且想创建一个样例沙盒，请按以下步骤操作：

1. 使用Docker Compose启动MongoDB：

docker-compose up -d

2. 使用测试数据填充数据库：

npm run seed

配置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": [
        "dist/index.js",
        "mongodb://root:example@localhost:27017/test?authSource=admin"
      ]
    }
  }
}

测试沙盒数据结构

种子脚本会创建三个带有示例数据的集合，具体信息如下：

用户

• 个人信息（姓名、电子邮件、年龄）
• 嵌套地址及其坐标
• 兴趣数组
• 成员资格日期

内容

• 文档标题
• 文档内容
• 创建日期
• 更新日期

订单

• 客户ID
• 订单详细信息
• 订单状态
• 订单日期

📄 许可证

此项目根据MIT许可证授权，有关详细信息，请参阅LICENSE文件。