aladin-mcp

알라딘 Open API를 활용한 MCP 서버입니다.

도구 목록

| 도구 | 설명 | |------|------| | search_aladin_books | 키워드·제목·저자·출판사로 책 검색 | | get_book_detail | ISBN/ItemId로 상세 조회 (리뷰·중고·목차·저자·베스트셀러 순위) | | get_book_list | 베스트셀러·신간·편집자 추천·블로거 베스트 리스트 | | get_used_stores | 중고 보유 매장 검색 | | get_book_cover_images | 앞표지·뒷표지·책등 이미지 URL 추출 (3D 커버용) |

설치

Claude Code CLI

claude mcp add aladin --env ALADIN_TTB_KEY="your_api_key_here" -- npx -y aladin-mcp

수동 설정 (.mcp.json)

{
  "mcpServers": {
    "aladin": {
      "command": "npx",
      "args": ["-y", "aladin-mcp"],
      "env": {
        "ALADIN_TTB_KEY": "your_api_key_here"
      }
    }
  }
}

환경변수

| 변수 | 필수 | 설명 | |------|------|------| | ALADIN_TTB_KEY | ✅ | 알라딘 Open API 키 |

개발

npm install
npm run build