io.github.rubatoyd/kosis-openapi-mcp
This server is an MCP/CLI for KOSIS OpenAPI that finds Korean statistical tables and indicators, inspects metadata, retrieves values while handling KOSIS quirks, and exports datasets.
Check connectivity and API key status, and read usage guidance.
Search statistical tables by name/content.
Browse the statistical list tree by topic, organization, etc.
Inspect table metadata such as items, period, source, and notes.
Read statistical explanations/survey overviews.
Retrieve table data values, with automatic classification-axis fitting and automatic period splitting when the 40,000-cell limit is exceeded.
Filter table data by period, recent N periods, classification codes, and item IDs.
Project a table into citation/bibliographic fields.
Collect/export data to xlsx, csv, json, or sqlite files.
Search major KOSIS indicators with full pagination recovery.
Retrieve indicator time-series values and apply client-side date filtering because the server ignores indicator date ranges.
Exports retrieved KOSIS statistical tables into a SQLite database file via the collect tool for local querying.
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/kosis-openapi-mcp Retrieve the consumer price index by month from 2020 to 2025 and export to xlsx"
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.
kosis-openapi-mcp
๐ ์ฌ์ฉ๋ โ ์ต๊ทผ 14์ผ ์กฐํ 0ํ(๊ณ ์ 0) ยท ํด๋ก 0ํ(๊ณ ์ 0) ยท ๋ฆด๋ฆฌ์ค ์์ฐ ๋์ ๋ค์ด๋ก๋ 145
2026-11-15 ์๋ ๊ฐฑ์ ยท ์ ์ฒด ์ด๋ ฅ์
docs/usage.csv. GitHub ํธ๋ํฝ ํต๊ณ๋ 14์ผ ์ฐฝ๋ง ์ ๊ณตํ๋ฏ๋ก ์ด ์ ์ฅ์๊ฐ ๋งค์ผ ์ฐ์ด ๋์ ํ๋ค.
KOSIS(๊ตญ๊ฐํต๊ณํฌํธ) ๊ณต์ ์๋น์ค OpenAPI ๋ฅผ ๊ฒ์ยท์์งํ๋ MCP ์๋ฒ + CLI.
ํต๊ณํ๋ฅผ ์ฐพ๊ณ , ํญ๋ชฉยท๋ถ๋ฅยท์ฃผ๊ธฐ๋ฅผ ํ์ธํ๊ณ , ์์น๋ฅผ ๋ฐ์ xlsxยทcsvยทjsonยทsqlite ๋ก ๋ด๋ณด๋ธ๋ค. 4๋ง ์ ์ ํ์ ๊ฑธ๋ฆฌ๋ฉด ๊ธฐ๊ฐ์ ์์์ ์ชผ๊ฐ ์ ์๋ฅผ ํ์ํ๋ค.
์๋งค ์ ์ฅ์: law-openapi-mcp(๋ฒ์ ์ฒ) ยท na-openapi-mcp(๊ตญํ๋์๊ด) ยท nl-openapi-mcp(๊ตญ๋ฆฝ์ค์๋์๊ด) ยท kci-openapi-mcp ยท scienceON-mcp
๋ฌด์์ ๋๋ ค์ฃผ๋
ํต๊ณ ๊ทธ ์์ฒด๋ค. ํ์ ๋ฉํ(์์ฑ๊ธฐ๊ดยท์กฐ์ฌ๋ช ยท์๋ก๊ธฐ๊ฐยท์ฃผ๊ธฐ)์ ์์น(์์ ร ๋ถ๋ฅ ร ํญ๋ชฉ โ ๊ฐ)๋ฅผ ๋๋ฉ์ธ ๊ทธ๋๋ก ์ค๋ค.
์์งยท์ธ์ฉ ํ์์ ๋ถ๊ฐ ๊ธฐ๋ฅ(kosis_citation)์ผ๋ก ๋ฐ๋ก ๋์๋ค. ์์ง๊ด๋ฆฌ ๋๊ตฌ๋ก
๋๊ธธ ๋๋ง ์ฐ๋ฉด ๋๊ณ , ๊ทธ ๋๊ตฌ๊ฐ ์๋ ์ ํ ๋ชฉ๋ก์ด ํต๊ณ ์๋ต์ ๋ชจ์์ ๋ฐ๊พธ์ง๋ ์๋๋ค.
Related MCP server: Korea Stats MCP
์ค๋น๋ฌผ
์ธ์ฆํค ํ๋. kosis.kr ํ์๊ฐ์ ํ ๊ณต์ ์๋น์ค ํ์ฉ์ ์ฒญ(์๋ ์น์ธ).
cp .env.example .env # KOSIS_API_KEY=... ๋ฅผ ์ฑ์ด๋ค๐ด ๋ฐ๊ธ๋ ๊ฐ์ ๊ทธ๋๋ก ๋ฃ์ผ์ธ์. base64 ์ฒ๋ผ ๋ณด์ฌ๋(๋์ด
=) ๋์ฝ๋ํ๋ฉดerr 11(์ ํจํ์ง ์์ ์ธ์ฆํค)์ด ๋ฉ๋๋ค.
์ค์นยท์คํ
uv sync
uv run kosis status
uv run kosis search ์ฌ๊ต์ก๋น
uv run kosis meta --org 101 --tbl DT_1PE201 --kind ITM # ํญ๋ชฉ ID ํ์ธ
uv run kosis data --org 101 --tbl DT_1PE201 --prd Y --start 2020 --end 2025
uv run kosis collect --org 101 --tbl DT_1B040A3 --prd M --start 202101 --end 202512
# ๋ถ๋ฅ์ถ์ด ์ฌ๋ฟ์ธ ํ๋ ๊ทธ๋๋ก โ ์ถ ๊ฐ์๋ ์์์ ๋ง์ถ๋ค(์ฐ์
ร ๊ท๋ชจ)
uv run kosis data --org 118 --tbl DT_118N_MON051 --prd H --start 202401 --end 202401
# ์ฃผ์์งํ(ํต๊ณํ์ ๋ค๋ฅธ ๊ณ์ด) โ ํ ๊ตฌ์กฐ๋ฅผ ๋ชฐ๋ผ๋ ๊ฐ๊น์ง ๋ฐ๋ก
uv run kosis indicator ์ถ์ฐ์จ
uv run kosis indicator-data --id 13 --start 2020 --end 2025MCP ๋ฑ๋ก:
{
"mcpServers": {
"kosis": {
"type": "stdio",
"command": "uvx",
"args": ["--from", "git+https://github.com/rubatoyd/kosis-openapi-mcp", "kosis-mcp"],
"env": { "KOSIS_API_KEY": "๋ฐ๊ธ๋ฐ์_๊ฐ_๊ทธ๋๋ก" }
}
}
}PyPI ์ ์ฌ๋ฆฐ ํจํค์ง๊ฐ ์์ง ์์ด ์ ์ฅ์์์ ๋ฐ๋ก ๋ฐ์ ์ด๋ค(์๋งค ์ ์ฅ์์ ๊ฐ์ ๋ฐฉ์).
main์ HEAD ๋ฅผ ์ฐ๋ฏ๋ก ๋ค์ ๊ธฐ๋์ ์ต์ ์ด ๋ฐ์๋๋ค.
MCP ๋๊ตฌ
๋๊ตฌ | ํ๋ ์ผ |
| ์ธ์ฆํค ๋ณด์ ์ฌ๋ถ + ์ค์ ์๋ณต 1ํ |
| ์๋น์ค๋ทฐยท์ฃผ๊ธฐยท๋ฉํ ์ข ๋ฅยท์ค๋ฅ์ฝ๋ยทํ๊ณยทํจ์ |
| ํต๊ณํ ์ฐพ๊ธฐ(ํตํฉ๊ฒ์) |
| ํต๊ณ๋ชฉ๋ก ํธ๋ฆฌ ํ ๋จ๊ณ(์ฃผ์ ๋ณยท๊ธฐ๊ด๋ณ โฆ) |
| ํ์ ํญ๋ชฉ(ITM)ยท๋ถ๋ฅ(NCD)ยท์ฃผ๊ธฐ(PRD)ยท์ถ์ฒ ๋ฑ |
| ํต๊ณ์ค๋ช (์กฐ์ฌ๊ฐ์) |
| ์์น โ 4๋ง ์ ์ด๊ณผ ์ ๊ธฐ๊ฐ ์๋ ๋ถํ |
| ํ๋ฅผ ์์ง ์นธ์ผ๋ก ํฌ์(๋ถ๊ฐ ๊ธฐ๋ฅ) |
| ์์น๋ฅผ xlsx/csv/json/sqlite ๋ก ์ ์ฅ |
| ์ฃผ์์งํ ์ฐพ๊ธฐ(ํต๊ณํ์ ๋ค๋ฅธ ๊ณ์ด) โ ํ์ด์ง ์ ์ ํ์ |
| ์ฃผ์์งํ์ ์์ ๋ณ ์์น โ ์๋ฒ๊ฐ ์ ๊ฑฐ๋ฅด๋ ์์ ์ ๋์ ๊ฑฐ๋ฅธ๋ค |
์์ ๋ ๊ฒ (์ ๋ถ ์ค์ธก)
172์ชฝ์ง๋ฆฌ ๊ณต์ ๊ฐ๋ฐ๊ฐ์ด๋๊ฐ ์๋๋ฐ๋ ๊ฐ์ฅ ์ค์ํ ์ ์ด ๊ทธ ์์ ์๊ฑฐ๋ ํ๋ฆฌ๋ค:
๐ด
jsonVD=Y๊ฐ ์์ผ๋ฉด JSON ์ด ์๋๋ค โ ํค์ ๋ฐ์ดํ๊ฐ ์๋ ์๋ฐ์คํฌ๋ฆฝํธ ๊ฐ์ฒด ๋ฆฌํฐ๋ด์ด ์จ๋ค. ์ด ํ๋ผ๋ฏธํฐ๋ ๊ฐ์ด๋์ ์ ๋ ฅ ๋ณ์ ํ์ ์๊ณ JSP ์์ ์์๋ง ์๋ค.๐ด ํต๊ณ์๋ฃ๋ฅผ
orgId/tblId๋ก ๋ถ๋ฅด๋ ค๋ฉด/openapi/Param/statisticsParameterData.do๋ฅผ ์จ์ผ ํ๋ค. ๊ฐ์ด๋๊ฐ ํ๋ฅผ ์ค์ด ๋statisticsData.do๋ก ๋ณด๋ด๋ฉด ํญ์ err 20.๐ด ์ธ์ฆํค๋ฅผ ๋์ฝ๋ํ์ง ๋ง ๊ฒ.
๊ทธ ๋ฐ์:
๐ด ๋ถ๋ฅ์ถ(
objL) ๊ฐ์๊ฐ ํ์ ์ถ ์์ ์ ํํ ๋ง์์ผ ํ๋ค โ ๋ชจ์๋ผ๋ฉดerr 20 (objL), ๋์น๋ฉดerr 21. ๊ทธ๋ฐ๋ฐ ์ถ ๊ฐ์๋ฅผ ์๋ ค ์ฃผ๋ ๋ฉํ ์๋น์ค๊ฐ ์๋ค(NCD๋ ๋ถ๋ฅ๊ฐ ์๋๋ผ ์ ๊ท์๋ก ์์ ์ด๊ณOBJยทCLS๋err 30).kosis_data๊ฐ ์ถ์ ํ๋์ฉ ๋๋ ค ๋ง์ถ๋ฏ๋ก ๋ค์ถ ํ(์: ์ฐ์ ร ๊ท๋ชจ)๋ ๊ทธ๋ฅ ๋ถ๋ฅด๋ฉด ๋๋ค โ ํ์ ๋ ์ถ์meta.obj_levels์ ์ค๋ฆฐ๋ค.๋ชจ๋ ์คํจ๊ฐ HTTP 200 ์ด๋ค. ์ฑ๊ณต์ ๋ฐฐ์ด, ์คํจ๋
{err, errMsg}๊ฐ์ฒด.Content-Type์ ๋ ๋คtext/html์ด๋ผ ๋ฏฟ์ ์ ์๋ค.err 30(๊ฒฐ๊ณผ ์์)์ ์ค๋ฅ๊ฐ ์๋๋ค โ 0๊ฑด๊ณผ ์คํจ๋ฅผ ๊ตฌ๋ถํด์ ๋ณด๊ณ ํ๋ค.์์ฒญ๋น 4๋ง ์ (err 31) ยท ๋ถ๋น 200๊ฑด(err 40).
ํ์ด์ง์ด ์๋ค โ ํตํฉ๊ฒ์ยท๋ชฉ๋กยทํต๊ณ์๋ฃ๋ ์๋ฒ๊ฐ ์ค ๋งํผ์ด ์ ๋ถ๋ค(์กฐ์ฉํ ์๋ฅด์ง ์๊ณ ์๋ฆฐ๋ค). ๋จ ํต๊ณ์ฃผ์์งํ ๊ณ์ด๋ง ์์ธ๋ก
pageNoยทnumOfRows๋ฅผ ๋ฐ๊ณ ์ ์ฃผ๋ฉด 10๊ฑด์์ ์๋ฆฐ๋ค โkosis_indicator_*๊ฐ ๋๊น์ง ๋๊ฒจ ์ ์๋ฅผ ํ์ํ๋ค(docs ยง7).๐ด ์ฃผ์์งํ ๊ณ์ด์ ์์ ๋ฒ์๋ฅผ ๊ฑฐ๋ฅด์ง ์๋๋ค(๋ชจ๋ ์ค์์น์ผ ๋ฟ ๊ฐ์ ๋ฌด์๋๋ค).
kosis_indicator_data๊ฐ ์ ๊ตฌ๊ฐ์ ๋ฐ์ ์ง์ ๊ฑฐ๋ฅด๊ณmeta.server_filtered=false๋ก ์๋ฆฐ๋ค.parentListId๋ ํ์๋ผ๊ณ ์ ํ ์์ง๋ง ์๋ตํ๋ฉด ์ต์์๊ฐ ์จ๋ค.
์์ธํ ๊ทผ๊ฑฐ์ ์ฌํ ๋ฐฉ๋ฒ์ docs/KOSIS_API_GUIDE.md.
๋ผ์ด์ ์ค
MIT
Available Tools
11 toolskosis_citationARead-only
ํต๊ณํ ํ๋๋ฅผ ์์ง(์ธ์ฉ) ์นธ์ผ๋ก ํฌ์ํ๋ค โ ์ ํ ๊ธฐ๋ฅ.
โ ๏ธ ์ด ๋๊ตฌ๋ ๋ถ๊ฐ ๊ธฐ๋ฅ์ด๋ค. ํต๊ณ๋ฅผ ์ฐ๋ ๊ฒ์ด ๋ชฉ์ ์ด๋ฉด kosis_search(ํ ๋ฉํ)์
kosis_data(์์น)๊ฐ ๋ณธ๋ น์ด๊ณ , ์ด ๋๊ตฌ๋ ์์ง๊ด๋ฆฌ ๋๊ตฌ๋ก ๋๊ธธ ๋๋ง ์ด๋ค.
KOSIS ๋ ์กฐ์ฌ(STAT_NM)์ ํ(TBL_NM) ๋ ์ธต์ ๋ค ์ฃผ๋ฏ๋ก ์ด๋ ์ธต์ผ๋ก ์ธ์ฉํ ์ง๋
๋ถ๋ฅด๋ ์ชฝ์ด ๊ณ ๋ฅธ๋ค โ container_title ์ด ์กฐ์ฌ์ธต, title ์ด ํ์ธต์ด๋ค.
Args: accessed: ์กฐํ์ผ์(YYYY-MM-DD). ๋ฐ์ดํฐ์ ์ธ์ฉ์๋ ์กฐํ์ผ์๊ฐ ํ์ํ๋ค.
Inputs: org_id (required), tbl_id (required), accessed.
kosis_collectC
ํต๊ณํ ์์น๋ฅผ ๋ฐ์ xlsx/csv/json/sqlite ๋ก ์ ์ฅํ๋ค.
โ ๏ธ ๋ถ๋ฅ ์ถ์ด ํ๋ง๋ค ๋ค๋ฅด๋ฏ๋ก ์ด ๊ตฌ์ฑ์ด ๊ฐ๋ณ์ด๋ค โ ๋ถ๋ฅ ์ด๋ฆ์ด ๊ทธ๋๋ก ์ด์ด ๋๋ค.
์ถ ๊ฐ์๋ ํ๋ง๋ค ๋ค๋ฅด์ง๋ง obj_l2~obj_l8 ์ ๋น์ ๋๋ฉด ์๋์ผ๋ก ๋ง์ถ๋ค.
Inputs: org_id (required), prd_se (required), tbl_id (required), out_dir (required), +14 more.
kosis_dataARead-only
ํต๊ณํ์ ์์น๋ฅผ ๋ฐ๋๋ค.
๐ด ๋ถ๋ฅ์ถ์ด ์ฌ๋ฟ์ธ ํ(์: ์ฐ์
ร ๊ท๋ชจ)๋ ๊ทธ๋ฅ ๋ถ๋ฅด๋ฉด ๋๋ค. KOSIS ๋ ์์ฒญ์
๋ถ๋ฅ์ถ ๊ฐ์๊ฐ ํ์ ์ถ ๊ฐ์์ ์ ํํ ๋ง๊ธฐ๋ฅผ ์๊ตฌํ๋๋ฐ(๋ชจ์๋ผ๋ฉด err 20 (objL),
๋์น๋ฉด err 21) ์ถ ๊ฐ์๋ฅผ ์๋ ค ์ฃผ๋ ๋ฉํ๊ฐ ์๋ค. ๊ทธ๋์ ์ด ๋๊ตฌ๊ฐ ์ถ์ ํ๋์ฉ
๋๋ ค ๊ฐ๋ฉฐ ๋ง์ถ๋ค โ ๊ฒฐ๊ณผ์ meta.obj_levels ์ ํ์ ๋ ์ถ์ด ์ค๋ฆฐ๋ค.
Args:
org_id: ๊ธฐ๊ด ID(์: '101').
tbl_id: ํต๊ณํ ID(์: 'DT_1B040A3').
prd_se: ์๋ก์ฃผ๊ธฐ โ Y(๋
)ยทH(๋ฐ๊ธฐ)ยทQ(๋ถ๊ธฐ)ยทM(์)ยทD(์ผ). kosis_meta(kind='PRD') ๋ก ํ์ธ.
start, end: ์์ ๋ฒ์(์: '202101''202512'). ๐ด ์ด ๋ฐฉ์์ด๋ฉด 4๋ง ์
์ ๋์ด๋
์๋์ผ๋ก ๊ธฐ๊ฐ์ ์ชผ๊ฐ ์ ์๋ฅผ ๋ฐ๋๋ค.
recent: ์ต๊ทผ N๊ฐ ์์ . start/end ๋์ ์ด๋ค(์ด ๋ฐฉ์์ ์๋ ๋ถํ ์ด ์ ๋๋ค).
obj_l1: ๋ถ๋ฅ1 โ 'ALL' ์ ์ฒด, '11' ํน์ , '11*' ํ์ ์ ์ฒด, '11+21' ์ฌ๋ฟ.
obj_l2 ~ obj_l8: ๋ถ๋ฅ28. ๋น์ ๋๋ฉด ํ์ํ ๋งํผ 'ALL' ๋ก ์๋์ผ๋ก ์ฑ์ด๋ค.
4๋ง ์
(err 31)์ ๊ฑธ๋ฆด ๋ ํน์ ์ฝ๋๋ก ์ขํ๋ ์๋ฆฌ์ด๊ธฐ๋ ํ๋ค.
items: ํญ๋ชฉ โ 'ALL' ๋๋ ํญ๋ชฉ ID(kosis_meta(kind='ITM')).
max_rows: ๋๋ ค์ค ์ต๋ ํ ์(ํ์ผ๋ก ๋ฐ์ผ๋ ค๋ฉด kosis_collect).
Inputs: org_id (required), prd_se (required), tbl_id (required), end, +12 more.
kosis_explainBRead-only
ํต๊ณ์ค๋ช (์กฐ์ฌ๊ฐ์) โ ๋ชฉ์ ยท๊ทผ๊ฑฐยท์ฃผ๊ธฐยท๋ฒ์ ๋ฑ.
ํต๊ณํ์๋ ์ด๋ก์ด ์์ผ๋ฏ๋ก, ๊ด๋ จ๋ ์ฑ์ ์ด๋ ์์ฝ์ด ํ์ํ ๋ ์ด ์ค๋ช ์ด ์ฌ๋ฃ๋ค.
Inputs: org_id (required), tbl_id (required).
kosis_guideARead-only
์ด API ๋ฅผ ์ธ ๋ ์์์ผ ํ ๊ฒ โ ์๋น์ค๋ทฐยท์ฃผ๊ธฐยท๋ฉํ ์ข ๋ฅยทํ๊ณยทํจ์ .
Inputs: no named parameters.
kosis_indicator_dataARead-only
์ฃผ์์งํ์ ์์ ๋ณ ์์น๋ฅผ ๋ฐ๋๋ค.
๐ด KOSIS ๊ฐ ์ด ๊ณ์ด์์๋ ์์ ๋ฒ์๋ฅผ ๊ฑฐ๋ฅด์ง ์๋๋ค. startPrdDe/endPrdDe ๋
๊ฐ์ด ๋ฌด์๋๊ณ ๋ชจ๋ ์ค์์น๋ก๋ง ์๋ํด์, ๋ฌด์์ ์ฃผ๋ ์ ๊ตฌ๊ฐ์ด ์จ๋ค(์ค์ธก).
๊ทธ๋์ ์ด ๋๊ตฌ๊ฐ ์ ๊ตฌ๊ฐ์ ๋ฐ์ ์ง์ ๊ฑฐ๋ฅด๊ณ , ๊ทธ ์ฌ์ค์ meta.server_filtered
(=false)์ meta.filter_note ๋ก ์๋ฆฐ๋ค โ ์๋ฒ๊ฐ ๊ฑธ๋ฌ ์คฌ๋ค๊ณ ๋ฏฟ์ผ๋ฉด ์์ฒญํ์ง
์์ ๊ตฌ๊ฐ์ ๋ฐ๊ณ ๋ ๋ชจ๋ฅธ๋ค.
Args:
jipyo_id: ์งํID(kosis_indicator_search ๋ก ์ฐพ๋๋ค).
start, end: ์์ ๋ฒ์(์: '2015'~'2025'). ๋น์ฐ๋ฉด ์ ๊ตฌ๊ฐ.
recent: ์ต์ N๊ฐ ์์ ๋ง(start/end ๋ฅผ ์ ์คฌ์ ๋).
Inputs: jipyo_id (required), end, start, recent.
kosis_indicator_searchARead-only
์ฃผ์์งํ๋ฅผ ์ด๋ฆ์ผ๋ก ์ฐพ๋๋ค โ ํต๊ณํ์๋ ๋ค๋ฅธ ๊ณ์ด์ด๋ค.
KOSIS ๋ ํต๊ณํ(TBL_ID) ๋ง๊ณ ์งํ(statJipyoId) ๊ณ์ด์ ๋ฐ๋ก ๋๋ค(ํฉ๊ณ์ถ์ฐ์จ,
์ถ๊ณ์ธ๊ตฌ โฆ). ํ ๊ตฌ์กฐ๋ฅผ ๋ชฐ๋ผ๋ ๋ฐ๋ก ๊ฐ์ ๋ณผ ์ ์๋ ๋์ , ์งํ๋ก ํ๋ ์ด์
๋ ๊ฒ๋ง
์๋ค. ํ ๋จ์๋ก ํ๊ณ ๋ค ๊ฑฐ๋ผ๋ฉด kosis_search ๋ฅผ ์ด๋ค.
๐ด ์ด ๊ณ์ด์๋ง ํ์ด์ง์ด ์๊ณ ์ ์ฃผ๋ฉด ์๋ฒ๊ฐ 10๊ฑด์์ ์๋ฅธ๋ค โ ์ด ๋๊ตฌ๊ฐ ๋๊น์ง
๋๊ฒจ ์ ์๋ฅผ ํ์ํ๋ค(meta.pages ์ ๋ช ์ชฝ์ ์ฝ์๋์ง ์ค๋ฆฐ๋ค).
Args: name: ์งํ๋ช (์: '์ถ์ฐ์จ', '์ธ๊ตฌ'). jipyo_id: ์งํID ๋ก ์ง์ ์ฐพ์ ๋(๋ ์ค ํ๋๋ ํ์). max_records: ๋๋ ค์ค ์ต๋ ๊ฑด์.
Inputs: name, jipyo_id, max_records.
kosis_listARead-only
ํต๊ณ๋ชฉ๋ก ํธ๋ฆฌ๋ฅผ ํ ๋จ๊ณ ํ๋๋ค(์ฃผ์ ๋ณยท๊ธฐ๊ด๋ณ ๋ฑ).
Args:
vw_cd: ์๋น์ค๋ทฐ ์ฝ๋. kosis_guide ์ ์๋น์ค๋ทฐ ์ฐธ์กฐ.
parent_id: ์์ ๋ชฉ๋ก ID. ๋น์ฐ๋ฉด ์ต์์๊ฐ ์จ๋ค(๊ฐ๋ฐ๊ฐ์ด๋๋ ํ์๋ผ ํ์ง๋ง
์ค์ ๋ก๋ ์๋ต ๊ฐ๋ฅ โ ์ค์ธก).
Inputs: vw_cd, parent_id.
kosis_metaARead-only
ํต๊ณํ์ ๋ฉํ์๋ฃ โ ํญ๋ชฉ(ITM)ยท์๋ก๊ธฐ๊ฐ(PRD)ยท์ถ์ฒ(SOURCE)ยท์ฃผ์(CMMT) ๋ฑ.
โ ๏ธ kosis_data ๋ฅผ ๋ถ๋ฅด๊ธฐ ์ ์ ITM ์ผ๋ก ํญ๋ชฉ ID ๋ฅผ, PRD ๋ก ์๋ก์ฃผ๊ธฐ๋ฅผ ํ์ธํ๋ฉด
err 20/21 ์ ํผํ ์ ์๋ค.
๐ด ๋ถ๋ฅ์ถ์ ์๋ ค ์ฃผ๋ ์ข
๋ฅ๋ ์๋ค. NCD ๋ ๋ถ๋ฅ๊ฐ ์๋๋ผ ์ ๊ท์๋ก ์์ ์ด๊ณ
OBJยทCLS ๋ err 30 ์ด๋ค(์ค์ธก) โ ์ถ์ kosis_data ๊ฐ ์์์ ๋ง์ถ๋ค.
โ ๏ธ ์๋ kind ๋ err 21 ์ด ์๋๋ผ err 30(0๊ฑด)์ผ๋ก ์ค๋ฏ๋ก ์คํ๊ฐ '์๋ฃ ์์'์ฒ๋ผ
๋ณด์ธ๋ค. ๊ทธ๋์ ์๋ ์ข
๋ฅ๋ง ๋ฐ๋๋ค โ ๊ฐ๋ฅํ ๊ฐ์ kosis_guide ์ ๋ฉํ_์ข
๋ฅ.
Inputs: org_id (required), tbl_id (required), kind.
kosis_searchARead-only
ํต๊ณํ๋ฅผ ์ด๋ฆยท๋ด์ฉ์ผ๋ก ์ฐพ๋๋ค(KOSIS ํตํฉ๊ฒ์).
Args: query: ๊ฒ์์ด(์: '์ฌ๊ต์ก๋น', '์ถ์ฐ์จ'). max_records: ๋๋ ค์ค ์ต๋ ๊ฑด์.
Inputs: query (required), max_records.
kosis_statusARead-only
์ฐ๊ฒฐ ์ ๊ฒ โ ์ธ์ฆํค ๋ณด์ ์ฌ๋ถ + KOSIS ์ค์ ์๋ณต 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 11 tools
Each tool has a single clear role: table search vs indicator search, table data vs indicator data, metadata vs survey explanation, data retrieval vs file export. The detailed descriptions explicitly distinguish the similar indicator/table families, so an agent can reliably choose between them.
All tools share the kosis_ prefix and snake_case, and the search/data pairs are parallel (kosis_search/kosis_indicator_search, kosis_data/kosis_indicator_data). However, the second part mixes bare verbs (search, list, explain, collect) with bare nouns (meta, data, citation, guide), so it is not a strict verb_noun convention.
11 tools is well within the ideal range and each one earns its place: status/guide for orientation, search/explain/list/meta/data for the table workflow, indicator_search/indicator_data for the indicator workflow, plus collect and citation for output and scholarship.
For a read-only statistical data API, the surface is complete: users can discover tables by search or tree, read survey descriptions and table metadata, fetch full table data with automatic axis/period handling, access major indicators, export to files, and generate citations. No obvious dead ends or missing core operations remain.
Maintenance
Related MCP Connectors
Korean national statistics (KOSIS) โ browse, search and pull time series from Statistics Korea'sโฆ
Search and query 1,500+ OECD statistical datasets via SDMX. Keyless.
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
Access Koreaโs G2B procurement and Nara Market data for bid notices, awards, contracts, statisticsโฆ
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables MCP clients like Claude Desktop to search, retrieve, and analyze Korean statistical data from KOSIS OpenAPI.1633 PyPI1MIT
- AlicenseAqualityCmaintenanceEnables natural language querying of Korean statistical data from KOSIS, including population, employment, GDP, housing prices, and more, with support for regional and trend analysis.810 npm18MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying Korean official statistics from KOSIS via natural language in MCP clients like Claude Desktop, wrapping the KOSIS OpenAPI for search, data retrieval, and metadata exploration.MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying Bank of Korea ECOS economic statistics via Open API, including searching tables, retrieving time series data, and accessing key indicators.MIT