Skip to main content
Glama
io.github.rubatoyd/kakao-book-mcp

io.github.rubatoyd/kakao-book-mcp

by rubatoyd

kakao-book-mcp

CI Release Downloads

๐Ÿ“Š ์‚ฌ์šฉ๋Ÿ‰ ํ†ต๊ณ„ โ€” ์ตœ๊ทผ 14์ผ ์กฐํšŒ 0ํšŒ(์ˆœ 0) ยท ํด๋ก  0ํšŒ(์ˆœ 0) ยท ๋ฆด๋ฆฌ์Šค ๋‹ค์šด๋กœ๋“œ 2๊ฑด

์ผ๋ณ„ ํด๋ก ยท์กฐํšŒ ์ถ”์ด

2026-11-17 ์ž๋™ ์ง‘๊ณ„๋จ ยท ์ „์ฒด ์ด๋ ฅ docs/usage.csv. GitHub ํŠธ๋ž˜ํ”ฝ API 14์ผ ์ฐฝ์„ ์˜๊ตฌ ๋ณด์กดํ•ฉ๋‹ˆ๋‹ค.

์นด์นด์˜ค Daum ์ฑ… ๊ฒ€์ƒ‰(Daum Book Search) Open API๋ฅผ Claude, Cursor ๋“ฑ MCP ํด๋ผ์ด์–ธํŠธ์—์„œ ๋ฐ”๋กœ ์“ฐ๋Š” MCP ์„œ๋ฒ„ + CLI ๋„๊ตฌ.
๋„์„œ๋ช…ยท์ €์žยท์ถœํŒ์‚ฌยทISBN ๊ฒ€์ƒ‰, ์ƒ์„ธ ์„œ์ง€ ๋ฐ ๊ฐ€๊ฒฉ/ํ• ์ธ์œจ ์ •๋ณด ์ˆ˜์ง‘, ๋‹ค์ค‘ ํ‚ค์›Œ๋“œ ์ผ๊ด„ ์ˆ˜์ง‘ ํ›„ xlsxยทcsvยทjsonยทsqlite ํŒŒ์ผ๋กœ ๋‚ด๋ณด๋ƒ…๋‹ˆ๋‹ค.

๐Ÿ“š ์ž๋งค ํ”„๋กœ์ ํŠธ: kci-openapi-mcp (KCI ํ•™์ˆ ๋…ผ๋ฌธยท์ธ์šฉ์ง€์ˆ˜) ยท scienceON-mcp (KISTI ๊ณผํ•™๊ธฐ์ˆ  ๋ฌธํ—Œ) ยท nl-openapi-mcp (๊ตญ๋ฆฝ์ค‘์•™๋„์„œ๊ด€ ๊ตญ๊ฐ€์„œ์ง€)


์ฃผ์š” ๊ธฐ๋Šฅ

  1. ๋„์„œ ๊ฒ€์ƒ‰ & ISBN ์กฐํšŒ:

    • ์ œ๋ชฉ, ์ €์ž/์—ญ์ž, ์ถœํŒ์‚ฌ, ISBN ํ•„๋“œ ํƒ€๊ฒŸํŒ… ๊ฒ€์ƒ‰

    • 10์ž๋ฆฌ / 13์ž๋ฆฌ ISBN ์ž๋™ ์ •๊ทœํ™” ๋ฐ ์กฐํšŒ

  2. ์กฐ์šฉํ•œ ์ ˆ๋‹จ(Quiet Truncation) ๋ฐฉ์ง€:

    • ์นด์นด์˜ค ์ฑ… ๊ฒ€์ƒ‰ API๋Š” ์ตœ๋Œ€ 50ํŽ˜์ด์ง€ * 50๊ฑด = 2,500๊ฑด์˜ ํŽ˜์ด์ง• ์ƒํ•œ์ด ์กด์žฌํ•ฉ๋‹ˆ๋‹ค.

    • ์‘๋‹ต์— total_count, pageable_count, is_end, truncated, cap_hit์„ ํ•จ๊ป˜ ์ „๋‹ฌํ•˜์—ฌ ๋ถ€๋ถ„ ์ˆ˜์ง‘์„ ์ „์ˆ˜๋กœ ์˜ค์ธํ•˜์ง€ ์•Š๋„๋ก ์•ˆ๋‚ดํ•ฉ๋‹ˆ๋‹ค.

  3. ๋Œ€๋Ÿ‰ ์ˆ˜์ง‘ & ๋‹ค์ค‘ ํฌ๋งท Export:

    • ๋ณต์ˆ˜ ๊ฒ€์ƒ‰์–ด์— ๋Œ€ํ•œ ์ž๋™ ํŽ˜์ด์ง• ๋ฐ ์ค‘๋ณต ์ œ๊ฑฐ(ISBN ๊ธฐ์ค€)

    • ์ถœํŒ์—ฐ๋„(year_from, year_to), ๊ฐ€๊ฒฉ(min_price, max_price), ํŒ๋งค์ƒํƒœ(status), ๋ณธ๋ฌธ ํ‚ค์›Œ๋“œ(contains) ํด๋ผ์ด์–ธํŠธ ํ•„ํ„ฐ๋ง

    • xlsx (์Šคํƒ€์ผ ์„œ์‹ ์ ์šฉ), csv (ํ•œ๊ธ€ Excel ํ˜ธํ™˜ UTF-8 BOM), json (์›๋ณธ raw ํฌํ•จ), sqlite ๋™์‹œ ์ €์žฅ

  4. ๊ต์œก๋ง/์‚ฌ๋‚ด๋ง SSL ์ธํ„ฐ์…‰์…˜ ๋Œ€์‘:

    • truststore ๋‚ด์žฅ์œผ๋กœ ๋ณ„๋„ ์ธ์ฆ์„œ ๋“ฑ๋ก ์—†์ด OS ์‹ ๋ขฐ ์ €์žฅ์†Œ ์ž๋™ ์—ฐ๋™


Related MCP server: scienceon-mcp

๋„๊ตฌ ๋ชฉ๋ก (MCP Tools)

๋„๊ตฌ๋ช…

์„ค๋ช…

์ฃผ์š” ์ธ์ž

kakao_book_status

์ธ์ฆํ‚ค ์œ ํšจ์„ฑ ์ ๊ฒ€ ๋ฐ ์นด์นด์˜ค API 1ํšŒ ํ”„๋กœ๋ธŒ ํ˜ธ์ถœ

์—†์Œ

kakao_book_search

ํ‚ค์›Œ๋“œ ๋„์„œ ๊ฒ€์ƒ‰

query, target (title|isbn|publisher|person), sort (accuracy|latest), page, size

kakao_book_isbn

ISBN ์ „์šฉ ์ƒ์„ธ ์กฐํšŒ (๋ณต์ˆ˜ ISBN ์ง€์›)

isbn (์‰ผํ‘œ ๊ตฌ๋ถ„ ๊ฐ€๋Šฅ)

kakao_book_collect

๋‹ค์ค‘ ๊ฒ€์ƒ‰์–ด ๋Œ€๋Ÿ‰ ์ˆ˜์ง‘ ๋ฐ ํŒŒ์ผ ์ €์žฅ

terms, target, sort, max_records, year_from, year_to, min_price, max_price, status, contains, formats, out_dir, name


์ธ์ฆํ‚ค ๋ฐœ๊ธ‰ ๋ฐ ์„ค์ • (1๋ถ„ ์†Œ์š”, ๋ฌด๋ฃŒ)

์นด์นด์˜ค Daum ์ฑ… ๊ฒ€์ƒ‰ API๋Š” ๋ฌด๋ฃŒ์ด๋ฉฐ ๋ณ„๋„์˜ ์Šน์ธ ์‹ฌ์‚ฌ ์—†์ด ์ฆ‰์‹œ ๋ฐœ๊ธ‰๋ฉ๋‹ˆ๋‹ค (์ผ์ผ ๊ธฐ๋ณธ 30,000๊ฑด ์ฟผํ„ฐ ์ œ๊ณต).

1. REST API ํ‚ค ๋ฐœ๊ธ‰ ๋ฐฉ๋ฒ•

  1. ์นด์นด์˜ค ๋””๋ฒจ๋กœํผ์Šค (developers.kakao.com) ์ ‘์† ๋ฐ ์นด์นด์˜ค ๊ณ„์ • ๋กœ๊ทธ์ธ

  2. ์ƒ๋‹จ ๋ฉ”๋‰ด์˜ [๋‚ด ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜] โžก๏ธ [์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ถ”๊ฐ€ํ•˜๊ธฐ] ํด๋ฆญ

    • ์•ฑ ์ด๋ฆ„: ์ž„์˜ ์ž…๋ ฅ (์˜ˆ: kakao-book-mcp)

    • ์‚ฌ์—…์ž๋ช…: ์ž„์˜ ์ž…๋ ฅ (์˜ˆ: ๊ฐœ์ธ ๋˜๋Š” ๋ณธ์ธ ์ด๋ฆ„)

  3. ์ƒ์„ฑ๋œ ์•ฑ ํด๋ฆญ โžก๏ธ ์ขŒ์ธก [์•ฑ ํ‚ค] (๋˜๋Š” [์•ฑ ์„ค์ •] > [์š”์•ฝ ์ •๋ณด])์—์„œ REST API ํ‚ค (32์ž๋ฆฌ 16์ง„์ˆ˜) ๋ณต์‚ฌ

2. ํ™˜๊ฒฝ๋ณ„ ํ‚ค ๋“ฑ๋ก ๋ฐฉ๋ฒ•

๋ณต์‚ฌํ•œ REST API ํ‚ค๋ฅผ ์‚ฌ์šฉ ํ™˜๊ฒฝ์— ๋งž์ถฐ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค:

์‚ฌ์šฉ ํ™˜๊ฒฝ

์„ค์ • ์œ„์น˜

์„ค์ • ๋ฐฉ๋ฒ•

Claude Desktop (.mcpb)

ํ™•์žฅ ์„ค์น˜ ์‹œ ํŒ์—…์ฐฝ

.mcpb ํŒŒ์ผ์„ Claude Desktop์— ๋“œ๋ž˜๊ทธ ์•ค ๋“œ๋กญ ํ›„ ๋‚˜ํƒ€๋‚˜๋Š” ์ž…๋ ฅ์ฐฝ์— ํ‚ค ๋ถ™์—ฌ๋„ฃ๊ธฐ

Claude Code

claude mcp add

--env KAKAO_API_KEY=YOUR_REST_API_KEY ์˜ต์…˜์œผ๋กœ ์ „๋‹ฌ

Antigravity / Gemini CLI

mcp_config.json

env.KAKAO_API_KEY ํ•ญ๋ชฉ์— ์„ค์ •

CLI / ํ„ฐ๋ฏธ๋„ ์ง์ ‘ ์‹คํ–‰

OS ํ™˜๊ฒฝ๋ณ€์ˆ˜ / .env

Windows ํ™˜๊ฒฝ๋ณ€์ˆ˜ ๋“ฑ๋ก ๋˜๋Š” ์ž‘์—… ํด๋”์˜ .env ํŒŒ์ผ์— KAKAO_API_KEY=... ์ž‘์„ฑ


์„ค์น˜ ๋ฐ MCP ๋“ฑ๋ก

1. Claude Desktop

%APPDATA%/Claude/claude_desktop_config.json (Windows) ๋˜๋Š” ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "kakao-book": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/rubatoyd/kakao-book-mcp", "kakao-book-mcp"],
      "env": {
        "KAKAO_API_KEY": "YOUR_KAKAO_REST_API_KEY",
        "KAKAO_OS_TRUST": "1"
      }
    }
  }
}

2. Claude Code

claude mcp add kakao-book --env KAKAO_API_KEY=YOUR_REST_API_KEY -- uvx --from git+https://github.com/rubatoyd/kakao-book-mcp kakao-book-mcp

3. Gemini CLI / Antigravity

ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ์˜ .agents/mcp_config.json ๋˜๋Š” ์ „์—ญ ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "kakao-book": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/rubatoyd/kakao-book-mcp", "kakao-book-mcp"],
      "env": {
        "KAKAO_API_KEY": "YOUR_KAKAO_REST_API_KEY",
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

4. Cursor / Windsurf / Cline

  • Command: uvx

  • Args: ["--from", "git+https://github.com/rubatoyd/kakao-book-mcp", "kakao-book-mcp"]

  • Env: KAKAO_API_KEY=...


CLI ์‚ฌ์šฉ๋ฒ•

# 1. ์ƒํƒœ ๋ฐ ์—ฐ๊ฒฐ ์ ๊ฒ€
uvx --from git+https://github.com/rubatoyd/kakao-book-mcp kbook status

# 2. ๋„์„œ ๊ฒ€์ƒ‰
uvx --from git+https://github.com/rubatoyd/kakao-book-mcp kbook search "์ธ๊ณต์ง€๋Šฅ" --target title --size 5

# 3. ISBN ์กฐํšŒ
uvx --from git+https://github.com/rubatoyd/kakao-book-mcp kbook isbn 9788996991342

# 4. ๋Œ€๋Ÿ‰ ์ˆ˜์ง‘ ๋ฐ ์—‘์…€/CSV/JSON ์ €์žฅ
uvx --from git+https://github.com/rubatoyd/kakao-book-mcp kbook collect --terms "๋”ฅ๋Ÿฌ๋‹" "๋จธ์‹ ๋Ÿฌ๋‹" --max 100 --format xlsx csv json --out ./output

๋กœ์ปฌ ๊ฐœ๋ฐœ ๋ฐ ์‹คํ–‰

ํด๋ผ์šฐ๋“œ ๋™๊ธฐํ™”(OneDrive ๋“ฑ)์™€์˜ ์ถฉ๋Œ ๋ฐ ์„ฑ๋Šฅ ์ €ํ•˜๋ฅผ ๋ฐฉ์ง€ํ•˜๊ธฐ ์œ„ํ•ด ๊ฐ€์ƒํ™˜๊ฒฝ์€ ํ”„๋กœ์ ํŠธ ์™ธ๋ถ€(C:\Users\rubat\.venvs\kakao-book)์— ๊ตฌ์„ฑ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.

# ๊ฐ€์ƒํ™˜๊ฒฝ ์ƒ์„ฑ ๋ฐ ํŒจํ‚ค์ง€ ์„ค์น˜
uv venv C:\Users\rubat\.venvs\kakao-book
uv pip install --python C:\Users\rubat\.venvs\kakao-book -e . pytest

# ํ…Œ์ŠคํŠธ ์‹คํ–‰
C:\Users\rubat\.venvs\kakao-book\Scripts\pytest.exe

# CLI ์‹คํ–‰
C:\Users\rubat\.venvs\kakao-book\Scripts\kbook.exe status

๋ผ์ด์„ ์Šค

MIT License.

Available Tools

4 tools
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: ํŒŒ์ผ ๊ธฐ๋ณธ ์ด๋ฆ„ (๊ธฐ๋ณธ๊ฐ’: ์ฒซ ๊ฒ€์ƒ‰์–ด ๊ธฐ์ค€ ์ž๋™ ์ƒ์„ฑ).

Inputs: terms (required), name, sort, status, +9 more.

kakao_book_isbnA
Read-only

[ISBN ๋„์„œ ์กฐํšŒ] ISBN(10์ž๋ฆฌ ๋˜๋Š” 13์ž๋ฆฌ, ํ•˜์ดํ”ˆ ํฌํ•จ ๊ฐ€๋Šฅ)์œผ๋กœ ๋„์„œ๋ฅผ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.

isbn: ์กฐํšŒํ•  ISBN ๋ฌธ์ž์—ด (์˜ˆ: '9788996991342', '8996991341', ์‰ผํ‘œ๋กœ ๋ณต์ˆ˜ ์ง€์ • ๊ฐ€๋Šฅ).

Inputs: isbn (required).

kakao_book_statusA
Read-only

[์—ฐ๊ฒฐ ์ ๊ฒ€] ์ธ์ฆํ‚ค ์„ค์ • ์—ฌ๋ถ€ ๋ฐ ์นด์นด์˜ค ์ฑ… ๊ฒ€์ƒ‰ API ์‹ค์ œ ์™•๋ณต 1ํšŒ ํ…Œ์ŠคํŠธ.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    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

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables querying a curated book database using MCP tools to retrieve basic or detailed book information by ISBN or title, including batch lookups.
      1
      ISC
    • A
      license
      A
      quality
      B
      maintenance
      Enables searching and collecting academic literature metadata from KISTI ScienceOn via Claude or CLI, supporting various document types and export formats.
      5
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables real-time book search, detailed information, and bestsellers from the Aladin OpenAPI, integrated with Claude Desktop via MCP.
      13 npm
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Search and harvest Korean academic literature and book bibliography metadata from the National Library of Korea Seoji OpenAPI via MCP or CLI.
      3
      2
      MIT