MongoDB MCP 服务器

这是一个为 MongoDB 数据库设计的模型上下文协议 (MCP) 服务器。该服务器能够分析 MongoDB 数据库的结构，并利用人工智能生成查询。

功能

1. ERD 生成（generateErd）

分析数据库的集合结构并生成实体关系图 (ERD)。

• 输入参数：

  {
    "database": "string",
    "collections": ["string"],  // 可选
    "format": "mermaid" | "json"  // 默认值: "mermaid"
  }
  

• 使用示例：

  {
    "database": "test",
    "format": "mermaid"
  }
  

2. 查询生成（generateQuery）

基于自然语言描述生成 MongoDB 查询。通过分析数据库的实际结构，提供准确的查询。

• 输入参数：

  {
    "database": "string",
    "collection": "string",
    "description": "string",
    "type": "mongodb" | "mongoose",  // 默认值: "mongodb"
    "includeExplanation": boolean  // 默认值: true
  }
  

• 使用示例：

  {
    "database": "test",
    "collection": "users",
    "description": "查找今天新注册的用户",
    "type": "mongodb"
  }
  

安装与运行

1. 安装依赖：

   npm install
   

2. 构建：

   npm run build
   

3. 启动服务器：

   node dist/index.js "mongodb://localhost:27017"
   

Claude Desktop 设置

在 macOS 上与 Claude Desktop 一起使用，请按照以下步骤配置：

1. 配置文件位置：~/Library/Application Support/Claude/claude_desktop_config.json

2. 添加 MCP 服务器配置：

   {
     "mcp": {
       "servers": [
         {
           "name": "mongodb",
           "command": "node /path/to/mongo-mcp-server/dist/index.js mongodb://localhost:27017/test"
         }
       ]
     }
   }
   

3. 重启 Claude Desktop

开发

项目结构

src/
├── index.ts          # 主服务器代码
├── tools/
│   ├── generateErd.ts    # ERD 生成工具
│   └── generateQuery.ts  # 查询生成工具

添加新工具

1. 在 src/tools 目录下创建新的工具文件
2. 实现工具接口：

   export const newTool = {
     parameters: {
       // 参数定义
     },
     async execute(params: any, context: { client: MongoClient }) {
       // 工具逻辑实现
     },
   };
   

3. 在 src/index.ts 注册新工具