io.github.rubatoyd/kakao-book-mcp
This MCP server lets you search and collect Korean book metadata through Kakao's Daum Book Search API.
Check API key validity and connectivity with
kakao_book_status.Search books by query, restricting to title, ISBN, publisher, or author/person, with sorting and pagination.
Look up one or more ISBNs, normalizing 10- or 13-digit ISBNs.
Bulk collect results for multiple terms, deduplicate by ISBN, and apply filters for year, price, sale status, and required keywords.
Export collected book data to
xlsx,csv,json, and/orsqlitefiles.Avoid quiet truncation by reporting total counts, paging limits,
truncated, andcap_hitstatus.
Provides tools for searching and collecting book data from the Kakao Daum Book Search API, including title/author/publisher/ISBN queries, ISBN normalization, bulk collection with duplicate removal and filtering, and export to XLSX, CSV, JSON, and SQLite.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@io.github.rubatoyd/kakao-book-mcp Search for books by Yuval Noah Harari and export the results to CSV"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
kakao-book-mcp
๐ ์ฌ์ฉ๋ ํต๊ณ โ ์ต๊ทผ 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 (๊ตญ๋ฆฝ์ค์๋์๊ด ๊ตญ๊ฐ์์ง)
์ฃผ์ ๊ธฐ๋ฅ
๋์ ๊ฒ์ & ISBN ์กฐํ:
์ ๋ชฉ, ์ ์/์ญ์, ์ถํ์ฌ, ISBN ํ๋ ํ๊ฒํ ๊ฒ์
10์๋ฆฌ / 13์๋ฆฌ ISBN ์๋ ์ ๊ทํ ๋ฐ ์กฐํ
์กฐ์ฉํ ์ ๋จ(Quiet Truncation) ๋ฐฉ์ง:
์นด์นด์ค ์ฑ ๊ฒ์ API๋ ์ต๋ 50ํ์ด์ง * 50๊ฑด = 2,500๊ฑด์ ํ์ด์ง ์ํ์ด ์กด์ฌํฉ๋๋ค.
์๋ต์
total_count,pageable_count,is_end,truncated,cap_hit์ ํจ๊ป ์ ๋ฌํ์ฌ ๋ถ๋ถ ์์ง์ ์ ์๋ก ์ค์ธํ์ง ์๋๋ก ์๋ดํฉ๋๋ค.
๋๋ ์์ง & ๋ค์ค ํฌ๋งท Export:
๋ณต์ ๊ฒ์์ด์ ๋ํ ์๋ ํ์ด์ง ๋ฐ ์ค๋ณต ์ ๊ฑฐ(ISBN ๊ธฐ์ค)
์ถํ์ฐ๋(
year_from,year_to), ๊ฐ๊ฒฉ(min_price,max_price), ํ๋งค์ํ(status), ๋ณธ๋ฌธ ํค์๋(contains) ํด๋ผ์ด์ธํธ ํํฐ๋งxlsx(์คํ์ผ ์์ ์ ์ฉ),csv(ํ๊ธ Excel ํธํ UTF-8 BOM),json(์๋ณธ raw ํฌํจ),sqlite๋์ ์ ์ฅ
๊ต์ก๋ง/์ฌ๋ด๋ง SSL ์ธํฐ์ ์ ๋์:
truststore๋ด์ฅ์ผ๋ก ๋ณ๋ ์ธ์ฆ์ ๋ฑ๋ก ์์ด OS ์ ๋ขฐ ์ ์ฅ์ ์๋ ์ฐ๋
Related MCP server: scienceon-mcp
๋๊ตฌ ๋ชฉ๋ก (MCP Tools)
๋๊ตฌ๋ช | ์ค๋ช | ์ฃผ์ ์ธ์ |
| ์ธ์ฆํค ์ ํจ์ฑ ์ ๊ฒ ๋ฐ ์นด์นด์ค API 1ํ ํ๋ก๋ธ ํธ์ถ | ์์ |
| ํค์๋ ๋์ ๊ฒ์ |
|
| ISBN ์ ์ฉ ์์ธ ์กฐํ (๋ณต์ ISBN ์ง์) |
|
| ๋ค์ค ๊ฒ์์ด ๋๋ ์์ง ๋ฐ ํ์ผ ์ ์ฅ |
|
์ธ์ฆํค ๋ฐ๊ธ ๋ฐ ์ค์ (1๋ถ ์์, ๋ฌด๋ฃ)
์นด์นด์ค Daum ์ฑ ๊ฒ์ API๋ ๋ฌด๋ฃ์ด๋ฉฐ ๋ณ๋์ ์น์ธ ์ฌ์ฌ ์์ด ์ฆ์ ๋ฐ๊ธ๋ฉ๋๋ค (์ผ์ผ ๊ธฐ๋ณธ 30,000๊ฑด ์ฟผํฐ ์ ๊ณต).
1. REST API ํค ๋ฐ๊ธ ๋ฐฉ๋ฒ
์นด์นด์ค ๋๋ฒจ๋กํผ์ค (developers.kakao.com) ์ ์ ๋ฐ ์นด์นด์ค ๊ณ์ ๋ก๊ทธ์ธ
์๋จ ๋ฉ๋ด์ [๋ด ์ ํ๋ฆฌ์ผ์ด์ ] โก๏ธ [์ ํ๋ฆฌ์ผ์ด์ ์ถ๊ฐํ๊ธฐ] ํด๋ฆญ
์ฑ ์ด๋ฆ: ์์ ์ ๋ ฅ (์:
kakao-book-mcp)์ฌ์ ์๋ช : ์์ ์ ๋ ฅ (์:
๊ฐ์ธ๋๋ ๋ณธ์ธ ์ด๋ฆ)
์์ฑ๋ ์ฑ ํด๋ฆญ โก๏ธ ์ข์ธก [์ฑ ํค] (๋๋ [์ฑ ์ค์ ] > [์์ฝ ์ ๋ณด])์์
REST API ํค(32์๋ฆฌ 16์ง์) ๋ณต์ฌ
2. ํ๊ฒฝ๋ณ ํค ๋ฑ๋ก ๋ฐฉ๋ฒ
๋ณต์ฌํ REST API ํค๋ฅผ ์ฌ์ฉ ํ๊ฒฝ์ ๋ง์ถฐ ์ค์ ํฉ๋๋ค:
์ฌ์ฉ ํ๊ฒฝ | ์ค์ ์์น | ์ค์ ๋ฐฉ๋ฒ |
Claude Desktop ( | ํ์ฅ ์ค์น ์ ํ์ ์ฐฝ |
|
Claude Code |
|
|
Antigravity / Gemini CLI |
|
|
CLI / ํฐ๋ฏธ๋ ์ง์ ์คํ | OS ํ๊ฒฝ๋ณ์ / | Windows ํ๊ฒฝ๋ณ์ ๋ฑ๋ก ๋๋ ์์
ํด๋์ |
์ค์น ๋ฐ 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-mcp3. 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:
uvxArgs:
["--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 toolskakao_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_isbnARead-only
[ISBN ๋์ ์กฐํ] ISBN(10์๋ฆฌ ๋๋ 13์๋ฆฌ, ํ์ดํ ํฌํจ ๊ฐ๋ฅ)์ผ๋ก ๋์๋ฅผ ์กฐํํฉ๋๋ค.
isbn: ์กฐํํ ISBN ๋ฌธ์์ด (์: '9788996991342', '8996991341', ์ผํ๋ก ๋ณต์ ์ง์ ๊ฐ๋ฅ).
Inputs: isbn (required).
kakao_book_searchARead-only
[๋์ ๊ฒ์] ์นด์นด์ค 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๋ก ๋ณด๊ณ ๋๋ฉฐ, ๊ฒ์์์ ์ธ๋ถํํด์ผ ํฉ๋๋ค.
Inputs: query (required), page, size, sort, +1 more.
kakao_book_statusARead-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
Scored across 4 tools
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.
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.
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.
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
Related MCP Connectors
Unofficial Gutendex MCP โ wraps Gutendex API for Project Gutenberg books (free, no auth)
Books MCP โ wraps Open Library API (free, no auth)
IEEE Xplore MCP โ BYOK wrapper over the IEEE Xplore Metadata Search APIโฆ
BookBrainz MCP โ open book metadata (MetaBrainz / sister of MusicBrainz)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables querying a curated book database using MCP tools to retrieve basic or detailed book information by ISBN or title, including batch lookups.1ISC
- AlicenseAqualityBmaintenanceEnables searching and collecting academic literature metadata from KISTI ScienceOn via Claude or CLI, supporting various document types and export formats.51MIT
- AlicenseNot gradedqualityDmaintenanceEnables real-time book search, detailed information, and bestsellers from the Aladin OpenAPI, integrated with Claude Desktop via MCP.13 npm3MIT
- AlicenseAqualityBmaintenanceSearch and harvest Korean academic literature and book bibliography metadata from the National Library of Korea Seoji OpenAPI via MCP or CLI.32MIT