National Assembly Library of Korea catalog search (books, theses, articles, bills)
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent โ or use 1-click editor setup below.
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag โ we're steadily working through the catalog.
๐ก Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
๐ ์ฌ์ฉ๋ โ ์ต๊ทผ 14์ผ ์กฐํ 14ํ(๊ณ ์ 3) ยท ํด๋ก 148ํ(๊ณ ์ 61) ยท ๋ฆด๋ฆฌ์ค ์์ฐ ๋์ ๋ค์ด๋ก๋ 7
2026-09-08 ์๋ ๊ฐฑ์ ยท ์ ์ฒด ์ด๋ ฅ์
docs/usage.csv. GitHub ํธ๋ํฝ ํต๊ณ๋ 14์ผ ์ฐฝ๋ง ์ ๊ณตํ๋ฏ๋ก ์ด ์ ์ฅ์๊ฐ ๋งค์ผ ์ฐ์ด ๋์ ํ๋ค.
๊ตญํ๋์๊ด(National Assembly Library of Korea) ์๋ฃ๊ฒ์ OpenAPI ๋ฅผ Claude ๋ฑ MCP ํด๋ผ์ด์ธํธ์์ ๋ฐ๋ก ์ฐ๋ ์๋ฒ + CLI. ๋์ยทํ์๋ ผ๋ฌธยท๊ตญ๋ด์ธ ๊ธฐ์ฌยท๊ตญํํ์๋กยท์์์ ๋ณด ๋ฑ 21์ข DB ๋ฅผ ๊ฒ์ยท์์งํ๊ณ xlsx/csv/json/sqlite ๋ก ๋ด๋ณด๋ ๋๋ค.
์๋งค ํ๋ก์ ํธ: nl-openapi-mcp(๊ตญ๋ฆฝ์ค์๋์๊ด ๋จํ๋ณธยทํ์๋ฌธํ) ยท kci-openapi-mcp(ํ์ ๋ ผ๋ฌธยท์ธ์ฉ์ง์) ยท scienceON-mcp(KISTI ๋ฌธํ)
์ด API ์ต๋์ ํจ์ ์ ๋๋ค. ํตํฉ๊ฒ์์ ๊ฒ์ํญ๋ชฉ ์ด๋ฆ์ ๋ชจ๋ฅด๋ฉด ๊ฑฐ๋ถํ์ง ์๊ณ ๊ฒ์์ด๋ฅผ ํต์งธ๋ก ๋ฌด์ํฉ๋๋ค.
์ ์๋ช
์ ์์ธ๊ฒ์์์๋ ์ ํจํ ์ด๋ฆ์ด๋ผ ์คํ๊ฐ ์๋๋ผ ํท๊ฐ๋ ค์ ์ฐ๊ธฐ ์ฝ์ต๋๋ค.
๊ทธ๋๋ก ๋๋ฉด 1,300๋ง ๊ฑด์ '๊ฒ์ ๊ฒฐ๊ณผ'๋ก ์ค์ธํ๊ฒ ๋ฉ๋๋ค.
โ ์ด ์๋ฒ๋ ํ์ดํธ๋ฆฌ์คํธ๋ก ํธ์ถ ์ ์ ๊ฑฐ๋ถํ๊ณ ์ฌ๋ฐ๋ฅธ ์ด๋ฆ์ ์๋ ค์ค๋๋ค.
| ๊ฒ์ํญ๋ชฉ | ์ค์ฑํ ๊ฒ์ ๊ฒฐ๊ณผ |
|---|---|
์ ์ฒด ยท ๊ธฐ๋ณธ๊ฒ์ ยท ์๋ฃ๋ช
ยท ์ ์ ยท ํค์๋ | 105 ยท 88 ยท 4 ยท 76 ยท 7 |
์ ์๋ช
ยท ISBN ยท ๋ฐํ๋
๋ ยท ์คํ | ๊ฐ 13,097,591 (์ ์ฒด DB) |
๋ฐ์ ๊ฒ์ด ์ ๋ถ์ธ์ง, ์๋ฆฐ ๊ฒ์ธ์ง๋ฅผ ํญ์ ๋ฉํ๋ก ์๋ ค์ค๋๋ค.
| ์ ํธ | ๋ป | ์ฒ๋ฐฉ |
|---|---|---|
truncated | max_records ์์ ๋ฉ์ถค | ์ฌ๋ฆฌ๋ฉด ํด๊ฒฐ |
cap_hit | total > ํ์ ํ๊ณ โ API ๊ฐ ๋ ์ ์ค | ๊ฒ์์์ ์ชผ๊ฐ์ผ ํจ |
early_stop_note | ์ ๋ ์ฝ๋ 0์ผ๋ก ์กฐ๊ธฐ ์ข ๋ฃ | ์ค๋ณต ์๋ตยท์๋ฒ ์ด์ ๊ฐ๋ฅ |
stopped_early_note | ์์ฐ ์์ง์ผ๋ก ์กฐํ์กฐ์ฐจ ๋ชป ํ ๊ฒ์์ด | max_records ์ํฅ |
zero_yield_warning | ์๋ฝ๋์ง๋ง ํญ์ 0๊ฑด์ธ ๊ฒ์ํญ๋ชฉ | ๋ค๋ฅธ ํญ๋ชฉ ์ฌ์ฉ |
option_ignored_warning | ์ฐ๋ ํํฐ๊ฐ ๋ฌด์๋จ(ํตํฉ๊ฒ์) | dbname ํจ๊ป ์ง์ |
ignored_search_warning | ์ ์ฒด ์นดํ๋ก๊ทธ ๊ท๋ชจ๊ฐ ๋ฐํ๋จ | ๊ฒ์ํญ๋ชฉ ํ์ธ |
toc_enrich_truncated_note | ๋ชฉ์ฐจ ํ๋ณด ์ค ์ผ๋ถ๋ง ๋ณด๊ฐ๋จ | toc_max ์ํฅ |
toc_enrich_incomplete_note | ๋ชฉ์ฐจ ์กฐํ ์คํจ ๊ฑด์ด ์์ | ์ํฅ์ ๋ฌด์๋ฏธ โ ์ ์ด๋ฒํธ ํ์ธ |
toc_enrich_aborted_note | ์ฟผํฐยทํค ๋ฌธ์ ๋ก ๋ณด๊ฐ ์ค๋จ | ์ํฅ์ ์คํ๋ ค ์
ํ โ na_status |
ํ์ ํ๊ณ๋ pageno ์ต๋ 99 ร page_size ์
๋๋ค(์ค์ธก). ๊ธฐ๋ณธ๊ฐ(1000)์ด๋ฉด 99,000๊ฑด์ด๊ณ ,
page_size ๋ฅผ ๋ฎ์ถ๋ฉด ํ๊ณ๋ ํจ๊ป ๋ฎ์์ง๋๋ค โ ์ด ์๋ฒ๋ ๊ทธ๊ฒ๊น์ง ๋ฐ์ํด ๋ณด๊ณ ํฉ๋๋ค.
๋ฌธ์(.hwp/.docx)๋ง ๋ณด๊ณ ๋ง๋ค๋ฉด ์กฐ์ฉํ ๊นจ์ง๋ ์ง์ ๋ค์ ๋๋ค.
| ํญ๋ชฉ | ๊ณต์ ๋ฌธ์ | โ ์ค์ |
|---|---|---|
| ๋ ์ฝ๋ ํ๊ทธ | <record> | <recode> โ ๋ฌธ์๋๋ก๋ฉด ์ ๊ฑด 0๊ฐ ํ์ + total ์ ์ ์ |
<item> ์์ ์์ | value โ name | name โ value |
| ์ ์ด๋ฒํธ ํ๋๋ช | controlno | ์ ์ด๋ฒํธ |
displaylines ์ํ | 100 | 1000 |
| ์ธ์ฆํค | (์ธ๊ธ ์์) | Encoding ๊ฐ์ URL ์ ์ง์ ๊ฒฐํฉํด์ผ ํจ |
| ํ์ด๋ผ์ดํธ ๋งํฌ์ | (์ธ๊ธ ์์) | ๋งค์นญ ํ๋์ <font color="red"> ์ฝ์
|
์ ์ฒด ๋์กฐํ์ ๊ทผ๊ฑฐ๋ docs/NA_API_GUIDE.md ์ ์์ต๋๋ค.
.mcpb ์ํด๋ฆญ๋ฆด๋ฆฌ์ค์์ ๋ด๋ ค๋ฐ์ ์คํํฉ๋๋ค.
๊ฒฝ๋๋ณธ(na-openapi-mcp.mcpb, uvx ๊ฒฝ์ )๊ณผ Pythonยทuv ์์ด ๋๋ ์์ฒด์๊ฒฐ๋ณธ
(win-x64 ยท macos-arm64 ยท linux-x64)์ด ์์ต๋๋ค.
stdio ์ ์ก์ด ๊ธฐ๋ณธ์
๋๋ค. HTTP ๊ฐ ํ์ํ๋ฉด
na-mcp --transport streamable-http --host 127.0.0.1 --port 9126
(ํ๊ฒฝ๋ณ์ NA_MCP_TRANSPORTยทNA_MCP_HOSTยทNA_MCP_PORT ๋ ์ง์).
๊ณต๊ณต๋ฐ์ดํฐํฌํธ data.go.kr ์์ ๊ตญํ ๊ตญํ๋์๊ด_์๋ฃ๊ฒ์ ์๋น์ค
(๋ฐ์ดํฐ์
15098174) ํ์ฉ์ ์ฒญ ํ ๋ฐ๊ธ๋ฐ์ต๋๋ค. ๊ฐ๋ฐ๊ณ์ ํธ๋ํฝ์ 10,000๊ฑด/์ผ ์
๋๋ค.
na_detailยทna_toc ๋ฅผ ์ฐ๋ ค๋ฉด ์์ธ์ ๋ณด์กฐํ ์๋น์ค(15098175)๋ ํจ๊ป ์ ์ฒญํ์ธ์ โ
์ธ์ฆํค๋ ๊ณ์ ๋จ์๋ผ ๊ฐ์ ํค๊ฐ ๊ทธ๋๋ก ํตํฉ๋๋ค.
๐ data.go.kr ์ ์ธ์ฆํค๋ฅผ Encoding / Decoding ๋ ๋ฒ๋ก ์ค๋๋ค. ์ด API ๋ Encoding ๊ฐ์ URL ์ ์ง์ ๊ฒฐํฉํด์ผ ํ๋๋ฐ(์ค์ธก), ๋ผ์ด๋ธ๋ฌ๋ฆฌ์
params=๋ก ๋๊ธฐ๋ฉด%2B๊ฐ%252B๋ก ์ด์ค ์ธ์ฝ๋ฉ๋์ด ์กฐ์ฉํ ์ธ์ฆ ์คํจํฉ๋๋ค. ์ด๋ ์ชฝ์ ๋ฃ๋ ์ฝ๋๊ฐ ์์์ ๋ณํํ๋ฏ๋ก ์ ๊ฒฝ ์ฐ์ง ์์๋ ๋ฉ๋๋ค.
| ๋๊ตฌ | ํ๋ ์ผ |
|---|---|
na_status | ์ธ์ฆํค ๋ณด์ ์ฌ๋ถ + ์ค์ ์๋ณต 1ํ |
na_search | ์๋ฃ๊ฒ์. ์ ๋จ ์ ํธ๋ฅผ ํจ๊ป ๋ฐํ |
na_collect | ๊ฒ์์ด ํฉ์งํฉ ์์ง โ xlsx/csv/json/sqlite. toc_max ๋ก ๋ชฉ์ฐจ ๋ณธ๋ฌธ ๋ณด๊ฐ(๊ธฐ๋ณธ ๋) |
na_detail | ์ ์ด๋ฒํธ 1๊ฑด ์์ธ์ ๋ณด |
na_toc | ์ ์ด๋ฒํธ 1๊ฑด ๋ชฉ์ฐจ |
na_fields | ๊ฒ์ํญ๋ชฉยทdbname ์ ํจ๊ฐ + ์ค์ธก ๊ทผ๊ฑฐ(census) |
๊ฒ์ํญ๋ชฉ,ํค์๋ ์
๋๋ค. | ๋ก ์ด์ผ๋ฉด AND ๋ก ๋ฌถ์
๋๋ค.
OR(ํฉ์งํฉ)์ API ์ ๋ฌธ๋ฒ์ด ์์ด na_collect(terms=[โฆ]) ๊ฐ ๋ง๋ญ๋๋ค.
ํตํฉ๊ฒ์ ๊ฒ์ํญ๋ชฉ(7์ข
): ๊ธฐ๋ณธ๊ฒ์ ์ ์ฒด ์๋ฃ๋ช
์ ์ ๋ฐํ์ ํค์๋ ์ฒญ๊ตฌ๊ธฐํธ
dbname ์ ์ง์ ํ๋ฉด ์์ธ๊ฒ์์ผ๋ก ์ ํ๋๋ฉฐ ๊ฒ์ํญ๋ชฉ ์ดํ๊ฐ DB๋ง๋ค ๋ฌ๋ผ์ง๋๋ค
(ํ์๋
ผ๋ฌธ=๋
ผ๋ฌธ๋ช
ยท์ง๋๊ต์, ๊ตญ๋ด๊ธฐ์ฌ=๊ธฐ์ฌ๋ช
, ํ์ ์งยท์ ๋ฌธ=์๋ก์ง๋ช
/์ ๋ฌธ๋ช
ํ ๋ฉ์ด๋ฆฌ).
์ ํํ ๋ชฉ๋ก์ na_fields ๋ก ํ์ธํ์ธ์.
๋ ์ฝ๋๋ ๊ณ ์ ์คํค๋ง๊ฐ ์๋๋๋ค. <item><name>ยท<value> ์์ด๊ณ ์ด๋ฆ ์งํฉ์ด
์๋ฃ์ข
๋ง๋ค ๋ค๋ฆ
๋๋ค โ ํ์ ํ๋๋ง ํด๋ ์๋ฃ๋ช
(๋์) / ๋
ผ๋ฌธ๋ช
(ํ์๋
ผ๋ฌธ) /
๊ธฐ์ฌ๋ช
(๊ธฐ์ฌ) / ์๋ก์ง๋ช
/์ ๋ฌธ๋ช
(ํ์ ์งยท์ ๋ฌธ) / ์ ๋๋ช
(์ ์์ ๋) / ์๊ฑด(ํ์๋ก) /
์์๋ช
(์์์ ๋ณด) / ๋ฒ์ญ๋ฒ๋ น๋ช
/ ํ๊ทธ๋ฆผ๋ช
์ผ๋ก ๊ฐ๋ฆฝ๋๋ค.
์๋ ค์ง ์ด๋ฆ์ ๊ณตํต ์ปฌ๋ผ์ผ๋ก ์ ๊ทํํ๊ณ ์๋ณธ์ raw ์ ๊ทธ๋๋ก ๋ณด์กดํฉ๋๋ค.
์ฃผ์ํ ๊ฐ๋ค(์ ๋ถ ์ค์ธก):
DDC ๋ 99.95% ๊ฐ ์ ์ํํ๋ก๋ง ์ด๋ ๊ฐ๋ฅํจ
์
๋๋ค. ์ ๊ทํ ํ๋๋ ๋น์ฐ๊ณ placeholder_fields ์ ์ด๋ฆ์ ๋จ๊น๋๋ค(์๋ฌธ์ raw ์).201u(MARC ๋ถํ์ ์ฐ๋), ๋น๊ฐ, 0.์ด๋ก์ ๋ฌด=Y ์ฌ๋ ์ด๋ก ๋ณธ๋ฌธ์ ๋ฐ์ ๋ฐฉ๋ฒ์ด ์์ต๋๋ค. ์์ ํ ํ
์คํธ๋
๊ตญํ์์์ ๋ณด(์ ์์ด์ ๋ฐ ์ฃผ์๋ด์ฉ)ยท๊ตญํํ์๋ก(๋ด์ฉ)์๋ง ์์ต๋๋ค.toc_max)์ ์ผฐ์ ๋๋ชฉ์ฐจ๊ฐ ์ ๋ถ๋ ์ด์ ๊ฐ ๋ค์ฏ์ด๊ณ ์ฒ๋ฐฉ์ด ์ ๋ถ ๋ค๋ฆ
๋๋ค. ๊ฐ์ ๋น์นธ์ผ๋ก ์์ผ๋ฉด "์ด ์๋ฃ์๋
๋ชฉ์ฐจ๊ฐ ์๋ค"๋ ์๋ชป๋ ๊ฒฐ๋ก ์ด ๋์ค๋ฏ๋ก, toc_status ์ปฌ๋ผ์ด ์ฌ์ ๋ฅผ ํ ๋จ์๋ก ๊ตฌ๋ถํฉ๋๋ค.
toc_status | ๋ป | ์ฒ๋ฐฉ |
|---|---|---|
ok | ๋ณธ๋ฌธ ํ๋ณด | โ |
skipped | ๋ชฉ์ฐจ ํ๋๊ทธ๊ฐ Y ๊ฐ ์๋๊ฑฐ๋ ์ ์ด๋ฒํธ ์์ โ ํธ์ถํ์ง ์์ | โ (์ฟผํฐ๋ฅผ ์ฐ์ง ์์) |
empty | ์ ์ ์๋ต์ธ๋ฐ ๋ณธ๋ฌธ์ด ์์ โ ํ๋๊ทธ๊ฐ ๊ฑฐ์ง์ด์๋ค | โ |
sentinel | ๋ณธ๋ฌธ์ด ๋ชฉ์ฐจ์ ๋ณด์์ ๋ฐ๋ณต | โ |
failed | ์กฐํ ์คํจ | na_toc ๋ก ๋จ๊ฑด ์ฌ์กฐํ |
not_attempted | ์์ฐ ์์งยท์ค๋จ์ผ๋ก ๋ชป ๋ถ๋ฆ | toc_max ์ํฅ |
has_toc='Y' ์ธ๋ฐ toc_status='empty' ์ธ ํ์ด ๊ฐ์ฅ ์ค์ํ ์ ํธ๋ผ ๋ ์ปฌ๋ผ์ ๋๋ํ ๋ก๋๋ค.
๋ณธ๋ฌธ(toc_text)์ jsonยทsqlite ์๋ง ์ค๋ฆฝ๋๋ค โ ์์ฒ ์๋ผ xlsx ์
์ํ(32,767)์ ๊ฑธ๋ฆฌ๊ณ
csv ๋ฅผ ๋น๋ํ๊ฒ ๋ง๋ญ๋๋ค.
tests/test_probe_instrumentation.py) โ ํ์ดํธ๋ฆฌ์คํธ๊ฐ ํ์นจ์ ์ถ๋ ฅ์ด๋ผ, ํ์นจ์ด ์กฐ์ฉํ
ํ๋ฆฌ๋ฉด ๊ทธ ์ค๋ฅ๊ฐ ๊ทธ๋๋ก ์ฝ๋๊ฐ ๋๊ธฐ ๋๋ฌธ์
๋๋ค. CI ๋ ํ
์คํธ๋ฟ ์๋๋ผ ํด๋ผ์ด์ธํธ๊ฐ ์ค์ ๋ก ๋์ธ ์ ์๋์ง๋ฅผ
๋ด
๋๋ค โ ์ ๊ท ์์กด์ฑ ํด์์์ mcp.server.fastmcp ์กด์ฌ ํ์ธ, ์ค์ stdio ํธ๋์
ฐ์ดํฌ,
๋๊ตฌ 6์ข
๋
ธ์ถ, ๋ฌดํค CLI ๊ธฐ๋, ๋น๋ฐ ํ์ผ ๋ฏธ์ถ์ .scripts/probe_*.py.docs/NA_API_GUIDE.md ์ ์์ต๋๋ค.MIT
Factual signals from GitHub, npm, and our automated checks โ not a rating.
No reviews yet โ be the first to share how this listing worked for you.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/na-openapi-mcp)<a href="https://allmcps.com/mcp/na-openapi-mcp"><img src="https://allmcps.com/api/badge/na-openapi-mcp?style=directory" alt="Na Openapi MCP on AllMCPs" /></a>