Serves as the HTTP client for connecting to the Aladin book search API, enabling book searches, detailed information retrieval, bestseller listings, and category exploration.
Powers the runtime environment for the Aladin book search MCP server, processing book search requests and responses.
Provides type safety for the Aladin book search implementation, ensuring reliable interactions with the book search API.
Handles schema validation for the Aladin book search server, ensuring proper data formatting and validation for book search queries and responses.
알라딘 도서 검색 MCP 서버 (Node.js)
알라딘 도서 검색 API를 활용한 MCP(Model Context Protocol) 서버입니다.
특징
- 도서 검색: 제목, 저자, 출판사, 키워드로 도서 검색
- 상세 정보: ISBN으로 도서 상세 정보 조회
- 베스트셀러: 알라딘 베스트셀러 목록 조회 (카테고리별 검색 지원)
- 카테고리 검색: 도서 카테고리 검색 및 조회 (상위 레벨 우선 표시)
알라딘 API 키 발급
이 MCP 서버를 사용하려면 알라딘의 API 키가 필요합니다.
- 알라딘 TTB 사이트에 접속
- 회원가입 및 로그인
- API 키 발급 신청
DXT 설치
- 클로드 데스크톱에서 [설정] - [확장프로그램]을 선택
- 다운 받은 DXT 파일을 드래그 앤 드롭
- API 키를 입력
설정
1. 의존성 설치 및 빌드
2. MCP 클라이언트에 정보 입력
도구 (Tools)
1. search_books
도서를 검색합니다.
매개변수:
query
(string): 검색어searchType
(enum): 검색 타입 (Title, Author, Publisher, Keyword)maxResults
(number): 최대 결과 개수 (1-100, 기본값: 10)start
(number): 검색 시작 번호 (기본값: 1)
2. get_book_detail
ISBN으로 도서 상세 정보를 조회합니다.
매개변수:
isbn
(string): 도서의 ISBN (10자리 또는 13자리)
3. get_bestsellers
도서 베스트셀러 목록을 조회합니다. 카테고리별 검색이 가능합니다.
매개변수:
queryType
(enum): 조회 타입 (Bestseller, ItemNewAll, ItemNewSpecial, ItemEditorChoice, BlogBest, 기본값: Bestseller)maxResults
(number): 최대 결과 개수 (1-100, 기본값: 10)start
(number): 검색 시작 번호 (기본값: 1)categoryId
(string, optional): 카테고리 ID (CID) - 특정 카테고리로 검색 제한
4. search_categories
도서 카테고리를 검색합니다. 상위 레벨 카테고리를 우선으로 표시합니다.
매개변수:
searchTerm
(string): 검색할 카테고리 이름maxResults
(number): 최대 결과 개수 (1-50, 기본값: 20)
5. get_popular_categories
자주 사용되는 주요 카테고리 목록을 조회합니다. 상위 레벨 카테고리를 우선으로 표시합니다.
매개변수:
limit
(number): 표시할 카테고리 개수 (1-50, 기본값: 20)
6. format_books_table
도서 정보를 표 형태로 정리하여 표시합니다. 검색, ISBN 조회, 베스트셀러 조회를 지원합니다.
매개변수:
type
(enum): 조회 타입 (search, isbn, bestseller)query
(string, optional): 검색어 (type이 search인 경우 필수)isbn
(string, optional): ISBN (type이 isbn인 경우 필수)searchType
(enum): 검색 타입 (Title, Author, Publisher, Keyword, 기본값: Title)queryType
(enum): 베스트셀러 조회 타입 (Bestseller, ItemNewAll, ItemNewSpecial, ItemEditorChoice, BlogBest, 기본값: Bestseller)maxResults
(number): 최대 결과 개수 (1-50, 기본값: 10)categoryId
(string, optional): 카테고리 ID (베스트셀러 조회 시 카테고리 제한)
사용 예시
MCP 클라이언트에서 다음과 같이 사용할 수 있습니다:
개발
프로젝트 구조
기술 스택
- Node.js: 런타임 환경
- TypeScript: 타입 안전성 (ES2020 타겟, ESNext 모듈)
- @modelcontextprotocol/sdk: MCP 프로토콜 구현
- axios: HTTP 클라이언트
- zod: 스키마 검증
개발 의존성
- tsx: TypeScript 개발 실행기
- @types/node: Node.js 타입 정의
빌드 설정
- 타겟: ES2020
- 모듈: ESNext
- 출력 디렉터리: dist/
- 소스맵: 포함
- 선언 파일: 생성
- JSON 모듈: 지원
환경 변수
라이선스
ISC
This server cannot be installed
MCP server that allows searching and retrieving book information from Aladin's book store API, including book details, bestseller lists, and category-based searches.
Related MCP Servers
- -securityAlicense-qualityAn MCP server that provides powerful search capabilities for Jewish texts and literature. This server enables Large Language Models to search and reference Jewish texts through a standardized interface.Last updated -12PythonMIT License
- -securityFlicense-qualityAn MCP server that integrates with SerpApi to retrieve search results from multiple search engines including Google, Bing, Yahoo, and others, enabling fast access to both live and archived search data.Last updated -Python
- -securityAlicense-qualityThe Apple Books MCP server bridges the gap between your personal reading journey and AI capabilities by transforming static book collections into interactive knowledge repositories.Last updated -6PythonApache 2.0
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server for the Open Library API that enables AI assistants to search for book information.Last updated -15TypeScriptMIT License