MongoDB 模型上下文协议 (MCP) 服务器用于 LLM

一个 Model Context Protocol (MCP) 服务器，使 LLM 能够直接与 MongoDB 数据库交互。通过自然语言查询集合、检查架构、管理和处理数据。

✨ 功能

• 🔍 集合架构检查
• 📊 文档查询和筛选
• 📈 索引管理
• 📝 文档操作（插入、更新、删除）

演示视频

https://github.com/user-attachments/assets/2389bf23-a10d-49f9-bca9-2b39a1ebe654

🚀 快速入门

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

MacOS: ~/Library/Application\ 支持/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 Server for 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. 运行 seed 脚本以创建测试数据：

npm run seed

配置 Claude Desktop

在不同操作系统下修改配置文件：

MacOS 和 Linux:
编辑 ~/.config/Claude/claude_config.json 文件，添加以下内容：

"mongo-mcp": {
  " connectionString": "mongodb://localhost:27017"
}

Windows:
编辑 %APPDATA%/Claude/claude_config.json 文件，添加类似的内容。

示例提示

基本操作

# 查询所有文档
/mongo-mcp --query '{"command": "findAll"}'

# 插入新文档
/mongo-mcp --insert '{"name": "test", "value": 123}'

高级查询

# 按条件查找
/mongo-mcp --search '{"name": "test"}' --projection '{"_id": 0, "name": 1}'

# 更新文档
/mongo-mcp --update '{"query": {"name": "test"}, "update": {"$set": {"value": 456}}}'

索引管理

# 创建索引
/mongo-mcp --create-index '{"collection": "users", "index": { "field": 1 }}'

# 删除索引
/mongo-mcp --drop-index '{"collection": "users", "indexName": "field_1"}'

可用工具

查询工具

• find: 查找所有文档
• search: 根据条件查找
• insert: 插入新文档
• update: 更新现有文档
• delete: 删除文档

索引工具

• create-index: 创建索引
• drop-index: 删除索引
• indexes: 列出集合的索引

📜 许可证

该项目使用 MIT License - 有关详细信息，请参阅 LICENSE 文件。