ne-kosis-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KOSIS_API_KEY | Yes | KOSIS 인증키 (필수) | |
| KOSIS_CACHE_DIR | No | API 응답 캐시 폴더 | <홈>/.ne-kosis-mcp/cache |
| KOSIS_EXPORT_DIR | No | 엑셀/CSV 저장 폴더. 지정을 권장합니다 | <작업 폴더>/exports |
| KOSIS_TOOLS_ALLOW | No | 노출할 도구 이름(쉼표 구분, 비우면 전체) | 전체 |
| KOSIS_CACHE_TTL_HOURS | No | 캐시 유지 시간 | 24 |
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| find_tableA | 자연어로 통계표를 찾습니다. 검증된 카탈로그(통계표 ID와 분류·항목 설명)를 먼저 보고, 없으면 KOSIS 통합검색으로 넘어갑니다. 통계 조회의 첫 단계입니다. |
| kosis_searchB | KOSIS 통합검색을 직접 실행합니다 (기관·정렬·페이지 지정 가능). 카탈로그에 없는 통계표를 찾을 때 씁니다. |
| kosis_listB | KOSIS 통계목록(주제별/기관별 분류 트리)을 한 단계씩 탐색합니다. |
| kosis_table_metaA | 통계표의 항목(ITM)과 분류(OBJ) 코드를 조회합니다. kosis_data에 넣을 코드를 확인하는 단계입니다. |
| kosis_dataA | 통계표 자료를 조회합니다 (기간 지정 또는 최근 N개 시점). 결과가 40,000셀을 넘으면 기간을 자동으로 나눠 받습니다. 행이 많으면 kosis_export를 쓰세요. |
| kosis_trendA | 통계표 자료를 시계열로 묶어 직전 시점 대비 증감·증감률과 구간 요약(변화량, 증감률, 연평균 성장률 CAGR)을 계산합니다. 거시 추이와 시장 규모 변화를 볼 때 씁니다. |
| kosis_exportA | 통계표 자료를 엑셀(xlsx)과 CSV로 저장합니다 (원자료 시트 + 시점별 가로 표 시트). 저장 폴더는 KOSIS_EXPORT_DIR로 지정합니다. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Most tools target distinct stages of the pipeline (navigate tree, find table, get codes, fetch data, analyze trend, export). The one soft overlap is find_table versus kosis_search, since both locate tables, but the descriptions clarify that find_table consults the catalog first while kosis_search hits KOSIS search directly. kosis_data and kosis_trend also both return data, but trend's change/CAGR framing distinguishes it.
Six of seven tools share a clean kosis_ prefix with snake_case (kosis_list, kosis_search, kosis_table_meta, kosis_data, kosis_trend, kosis_export). The lone deviation is find_table, which drops the prefix and reads as an English verb_noun outlier. Minor but noticeable inconsistency.
Seven tools is well-scoped for a statistics retrieval service, with each tool mapping to a clear stage (discover, inspect schema, fetch, analyze, export). No redundant or filler tools.
The surface covers the full read-only lifecycle: tree navigation, catalog/search discovery, metadata codes, data retrieval, trend analysis, and export. As a read-only data source there is no CRUD update/delete gap, though the slight find_table/kosis_search overlap hints at a small redundancy rather than a true hole.