통계표 ID를 찾고, 분류 코드를 조립하고, 자치구 행을 스크롤하던 일을 자연어 한 줄로. 시정연설·의회 답변·정책보고서·민원 응대 — 모든 답변에 통계표 ID(출처)가 자동으로 붙어 그대로 인용 가능. ChatGPT가 학습 시점 기억으로 찍어준 옛 수치를 보고서에 넣는 사고를 막는다.
일반 AI는 통계 수치를 학습 시점 기준으로 기억한다. "서울 인구"를 물으면 몇 년 전 값을 자신 있게 답한다. 그 수치가 보고서·연설문·국정감사 자료에 들어가면 사고다. 이 커넥터는 매번 KOSIS 공식 DB를 실시간 조회하고, 답변에 통계표 ID를 함께 표기한다. 추정이 아니라 인용이다.
PRD_SE='S')
📊 출처: 시군구별 경제활동인구 · KOSIS DT_1ES3A03_A01S
KOSIS DT_xxx가 자동으로 따라붙는다. 발표자료·국감자료·보도자료에 그대로 각주로 복사. 사후 검증·재인용도 한 번에.
노령화지수 등 장래추계 통계는 "이 수치는 통계청 추계"라는 안내가 자동 부착. 미래 추계를 실측처럼 인용하는 실수를 차단.
자치구 단위 데이터가 KOSIS에 없으면 광역시도 값을 자치구인 척 답하지 않고 "광역시도 값으로 대체"를 첫 문장에 명시. 무결성 1순위.
동일 질의는 6시간 캐싱해 빠르게 응답하되, 통계 갱신 주기를 해치지 않는다. 다중 사용자 동시 호출에서도 KOSIS API 쿼터 안정.
"광진구" 고용률을 물으면 일반 검색은 늘 "서울특별시" 평균만 돌려준다. 이 도구는 KOSIS 표준 통계표(자치구 코드 라우팅)를 1순위로, 표준표 미수록 분야는 자치구 통계연보 .xlsx로 보완. 「중구」·「남구」처럼 여러 시에 있는 이름도 "부산 중구"로 광역시를 같이 말하면 정확히 구분한다.
v1.7부터 KOSIS 표준 OpenAPI(자치구 코드 라우팅)를 1순위로. 전국 226개 시군구가 동일 구조라 일관성·다지역 비교가능성이 보장된다. 표준표에 없는 분야만 자치구 통계연보 .xlsx의 보조 경로로 떨어진다. chain_compare_regions는 같은 지표가 지역별로 다른 통계표에서 조회되면 비교가능성 경고를 자동 부착.
자치구마다 통계연보 분야 순서가 다르다. v1.7에서 file_sn을 분야명 매칭으로 자치구별 동적 도출하도록 수정 — 엉뚱한 분야 파일을 읽던 문제 차단. kordoc 엔진이 직접 .xlsx 파싱.
자연어 한 줄로 다중 KOSIS 호출을 묶어 한 응답으로 정리한다. chain_region_brief는 연설 한 단락, chain_compare_regions는 의회 답변 비교표, chain_policy_indicator는 5개년 계획 시계열.
chain_region_briefchain_compare_regionschain_policy_indicator"민선 8기 출산율 추이", "임기 4년차 GRDP", "작년 대비 실업률", "역대 인구" — quick_trend가 한국 공직 어법을 자동으로 분석 연수로 환산.
연도별 데이터포인트뿐 아니라 연평균 성장률(CAGR)·표준편차·추세선까지. 정책효과 분석 시 통계학적 근거로 활용.
같은 통계표 안에서 시점별·항목별 정밀 비교. "2010 vs 2025 합계출산율 변화", "광진구 vs 강남구 동일 시점" 한 호출로.
주제별·기관별 트리 탐색 + 분야별 추천. 검색 키워드가 떠오르지 않을 때 KOSIS 분류 체계를 따라 흐른다.
KEYWORD_ALIASES 100종 이상. 줄임말·구어체·률/율 오타·공백·영문도 자동 변환. "출산률"·"고용율"·"G D P"·"population" 모두 인식.
| 분야 | 키워드 예시 |
|---|---|
| 인구·출산·고령 | 인구 · 출산율 · 출생아수 · 사망률 · 기대수명 · 고령인구 · 노령화지수 |
| 혼인·이혼 | 혼인건수 · 이혼율 · 초혼연령 · 평균초혼연령 |
| 고용·소득 | 실업률 · 고용률 · 취업자수 · 경제활동인구 · 월평균임금 |
| 경제 | GDP · 경제성장률 · 물가(소비자물가지수) · GRDP(지역내총생산) |
| 무역 | 수출 · 수입 · 무역수지 |
| 주거 | 주택매매가격 · 아파트가격 · 전세가격 |
| 환경·교통·사회 | 미세먼지(PM2.5/PM10) · 자동차등록 · 교통사고 · 범죄율 · 의사수 · 외래관광객 |
quick_stats · quick_trend · 체인 3종이 일상 질의의 90%. 나머지는 정밀 조회용.
Claude.ai 웹 커넥터(설치 없음) · AI 데스크톱 앱(원클릭 자동 등록) · 로컬 설치(오프라인). KOSIS OpenAPI 키는 무료 발급.
Claude Pro/Max/Team — 설정 → 커넥터 → 커스텀 커넥터 추가. URL 한 줄.
https://korean-stats-mcp.fly.dev/mcp
원클릭 자동 등록 — 설정 파일 백업 후 등록, 다른 MCP 서버는 그대로.
# macOS / Linux curl -fsSL https://raw.githubusercontent.com/chrisryugj/korean-stats-mcp/main/install.sh | bash # Windows (PowerShell) irm https://raw.githubusercontent.com/chrisryugj/korean-stats-mcp/main/install.ps1 | iex
KOSIS API 키(무료)와 Node.js 20+. 로컬 실행 시 .env에 키 저장.
git clone https://github.com/chrisryugj/korean-stats-mcp cd korean-stats-mcp pnpm install && pnpm run build