# Apidog MCP Server (HTTP)

HTTP 기반 Model Context Protocol (MCP) 서버로, API 문서를 AI 도구에서 활용할 수 있게 해줍니다.

## 기능

- **API 엔드포인트 검색**: 키워드로 API 검색
- **엔드포인트 상세 조회**: 파라미터, 요청/응답 스키마 확인
- **스키마 조회**: 모델/스키마 정의 조회
- **프로젝트 정보**: API 통계 및 메타데이터

## Requirements

- Node.js 18+
- pnpm

## 설치

```bash
pnpm install
```

## 설정

`.env` 파일:

```env
PORT=3333

# 방법 1: Apidog 프로젝트 사용
APIDOG_ACCESS_TOKEN=your-token
APIDOG_PROJECT_ID=your-project-id

# 방법 2: OpenAPI/Swagger URL 직접 사용
APIDOG_OAS_URL=https://petstore3.swagger.io/api/v3/openapi.json

# 선택: MCP 서버 인증 (설정하지 않으면 인증 없이 접근)
MCP_API_KEY=your-mcp-api-key
```

## 실행

```bash
# 개발
pnpm dev

# 프로덕션
pnpm build
pnpm start
```

## MCP 도구

| 도구 | 설명 |
|------|------|
| `apidog_search` | 키워드로 API 엔드포인트 검색 |
| `apidog_get_endpoint` | 특정 엔드포인트 상세 정보 조회 |
| `apidog_list_endpoints` | 모든 엔드포인트 목록 |
| `apidog_get_schema` | 스키마/모델 정의 조회 |
| `apidog_project_info` | 프로젝트 정보 및 통계 |
| `apidog_refresh` | 캐시 갱신 |

## Claude Desktop 설정

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "apidog": {
      "url": "http://localhost:3333/mcp",
      "transport": "http"
    }
  }
}
```

인증 필요 시:

```json
{
  "mcpServers": {
    "apidog": {
      "url": "http://localhost:3333/mcp",
      "transport": "http",
      "headers": {
        "x-api-key": "your-mcp-api-key"
      }
    }
  }
}
```

## API 테스트

```bash
# 헬스 체크
curl http://localhost:3333/mcp

# Initialize
curl -X POST http://localhost:3333/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

# 도구 목록
curl -X POST http://localhost:3333/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

# API 검색
curl -X POST http://localhost:3333/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"apidog_search","arguments":{"keyword":"user"}}}'
```

## Docker

```bash
docker build -t apidog-mcp-server .
docker run -p 3333:3333 --env-file .env apidog-mcp-server
```