MongoDB MCP 服务器

用于 MongoDB 数据库的 Model Context Protocol (MCP) 服务器。 此服务器分析 MongoDB 数据库的结构，并提供使用 AI 生成查询的功能。

功能

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 中注册工具