Skip to main content
Glama
rubatoyd

io.github.rubatoyd/kakao-book-mcp

by rubatoyd
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
KAKAO_API_KEYYesYour Kakao REST API key (32-character hex) required for Daum Book Search API.
KAKAO_OS_TRUSTNoSet to '1' to enable OS trust store integration for SSL interception environments.
PYTHONIOENCODINGNoSet to 'utf-8' to ensure UTF-8 output.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
kakao_book_statusA

[연결 점검] 인증키 설정 여부 및 카카오 책 검색 API 실제 왕복 1회 테스트.

kakao_book_searchA

[도서 검색] 카카오 Daum 책 검색 API로 도서를 검색합니다.

query: 검색을 원하는 질의어 (필수). target: 검색 필드 제한 (title: 제목, isbn: ISBN, publisher: 출판사, person: 인명/저자/역자). 기본값은 전체. sort: 정렬 방식 (accuracy: 정확도순, latest: 발간일순). 기본값: accuracy. page: 결과 페이지 번호 (1 ~ 50). size: 한 페이지에 보여질 문서 수 (1 ~ 50, 기본값 10).

⚠️ 카카오 API는 최대 50페이지 * 50건 = 2,500건까지만 페이징을 지원합니다. total_count가 2,500을 넘으면 cap_hit=true로 보고되며, 검색식을 세분화해야 합니다.

kakao_book_isbnA

[ISBN 도서 조회] ISBN(10자리 또는 13자리, 하이픈 포함 가능)으로 도서를 조회합니다.

isbn: 조회할 ISBN 문자열 (예: '9788996991342', '8996991341', 쉼표로 복수 지정 가능).

kakao_book_collectA

[도서 대량 수집 및 내보내기] 여러 검색어/필터 조건으로 도서를 자동 페이징 수집하고 중복 제거 후 로컬 파일로 저장합니다.

terms: 검색어 단일 문자열 또는 문자열 리스트 (예: ['인공지능', '머신러닝']). target: 검색 대상 필드 (title, isbn, publisher, person, 기본값: 전체). sort: 정렬 방식 (accuracy, latest). max_records: 검색어당 최대 수집 건수 (기본 50, 최대 2500). year_from / year_to: 출판연도 필터 (YYYY 형식, 클라이언트 후처리). min_price / max_price: 가격 범위 필터 (원 단위, 클라이언트 후처리). status: 도서 상태 필터 (예: '정상판매', '품절', '절판'). contains: 본문/제목/저자/출판사에 반드시 포함되어야 할 추가 키워드. formats: 저장할 파일 포맷 리스트 (['xlsx', 'csv', 'json', 'sqlite'], 기본값: ['xlsx', 'csv', 'json']). out_dir: 저장할 폴더 경로 (기본값: ./output). name: 파일 기본 이름 (기본값: 첫 검색어 기준 자동 생성).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.4/5.0

Scored across 4 tools

Disambiguation4/5

The tools are mostly distinct: status checks connectivity, search does general queries, isbn is a specialized lookup by ISBN, and collect is a batch operation. However, search with target='isbn' overlaps with the isbn tool, which could cause confusion about which to use.

Naming Consistency5/5

All tools follow a consistent kakao_book_<action> snake_case pattern with clear action words (status, search, isbn, collect). The naming is predictable and uniform across the set.

Tool Count5/5

With 4 tools, the server is well-scoped for a book search API wrapper. It covers a health check, basic search, ISBN lookup, and batch collection without unnecessary bloat.

Completeness5/5

The tool surface covers the core read-only operations for a search API: single search, ISBN lookup, and bulk collection with filters and export. No obvious lifecycle operations are missing since the domain is read-only.

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Resources