MongoDB MCP Server

MongoDB 데이터베이스를 위한 Model Context Protocol (MCP) 서버입니다. 이 서버는 MongoDB 데이터베이스의 구조를 분석하고, AI를 활용하여 쿼리를 생성하는 기능을 제공합니다.

기능

1. ERD 생성 (generateErd)

데이터베이스의 컬렉션 구조를 분석하여 ERD(Entity Relationship Diagram)를 생성합니다.

입력 파라미터:

{
  "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"
}

설치 및 실행

의존성 설치:
```
npm install
```
빌드:
```
npm run build
```

서버 실행:

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

Claude Desktop 설정

macOS에서 Claude Desktop과 함께 사용하려면 다음과 같이 설정하세요:

설정 파일 위치: ~/Library/Application Support/Claude/claude_desktop_config.json

MCP 서버 설정 추가:

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

Claude Desktop 재시작

개발

프로젝트 구조

src/
├── index.ts          # 메인 서버 코드
├── tools/
│   ├── generateErd.ts    # ERD 생성 도구
│   └── generateQuery.ts  # 쿼리 생성 도구

새로운 도구 추가

src/tools 디렉토리에 새 도구 파일 생성

도구 인터페이스 구현:

export const newTool = {
  parameters: {
    // 파라미터 정의
  },
  async execute(params: any, context: { client: MongoClient }) {
    // 도구 로직 구현
  },
};

src/index.ts에 도구 등록