Skip to main content
Glama
samhyun

Apidog MCP Server

by samhyun

Apidog MCP Server (HTTP)

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

기능

  • API 엔드포인트 검색: 키워드로 API 검색

  • 엔드포인트 상세 조회: 파라미터, 요청/응답 스키마 확인

  • 스키마 조회: 모델/스키마 정의 조회

  • 프로젝트 정보: API 통계 및 메타데이터

Related MCP server: OpenAPI Search MCP Server

Requirements

  • Node.js 18+

  • pnpm

설치

pnpm install

설정

.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

실행

# 개발
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:

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

인증 필요 시:

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

API 테스트

# 헬스 체크
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

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to fetch and understand API endpoint definitions from Apifox projects in real-time. Supports retrieving complete API specifications including request methods, parameters, headers, and response schemas to improve development efficiency and code generation quality.
    1
    13 npm
    4
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to load, parse, and query OpenAPI/Swagger documentation from URLs with intelligent search across endpoints, schemas, and authentication methods. Provides 10 specialized tools for comprehensive API exploration including path details, operation lookups, and multi-criteria search capabilities.
    4
    -
  • A
    license
    A
    quality
    D
    maintenance
    Exposes Swagger/OpenAPI API documentation to AI models, enabling exploration, search, and interaction with endpoints, schemas, and execution of API calls.
    14
    1 npm
    2
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables AI assistants to query API documentation from Eolink Apikit instances via the Eolink Open API, supporting listing projects, groups, searching APIs by keyword/path, and retrieving detailed API definitions.
    6
    8 npm
    MIT