Mongodb MCP

🚀 🗄️ MongoDB MCP 服务器用于LLM

一个模型上下文协议（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为Claude Desktop自动安装MongoDB MCP服务器，可执行以下命令：

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文件。