Show GN: korea-data-mcp – AI 에이전트가 한국 공공 API를 틀리게 읽지 않도록 해주는 MCP 서버

DART, 공공데이터포털, 국가법령정보 API를 MCP 서버로 묶었습니다. Claude, Cursor 같은 AI 에이전트가 한국 기업·부동산·법령 데이터를 정확히 조회하도록 만드는 게 목표입니다.

만들게 된 계기

• 공공 API 응답을 에이전트에 그대로 넘기면 그럴듯하지만 틀린 답이 나옵니다.
• 예: DART 반기보고서에서 삼성전자 2025년 상반기 매출을 물으면 74.6조라고 답합니다. thstrm_amount가 반기 누적이 아니라 2분기 3개월치이기 때문입니다. 실제 상반기 누적은 153.7조입니다.

이런 함정을 서버에서 처리합니다 (현재 47개)

• 법령: '현행 법령' 본문에 아직 시행되지 않은 개정 조문이 섞여 있습니다. 기준일에 시행 중인 버전을 골라 주고, 시행 예정 조문은 시행일과 함께 표시합니다.
• 아파트 실거래가: 해제된 계약이 정상 거래처럼 섞여 옵니다. 기본으로 빼고 중앙값을 계산합니다.
• 2026년 행정구역 개편: 옛 지역 코드를 넣으면 지난달 데이터까지 0건이 나옵니다. 바뀐 코드를 알려줍니다.
• 그 밖에 '성공, 0건'으로 오는 잘못된 입력, 만원 단위 금액, 2자리 연도 날짜 등을 다룹니다. 전체 목록: docs/QUIRKS.ko.md

쓸 수 있는 것 (tool 15개)

• DART 기업·공시·재무제표, 주가, 기업 기본정보, 사업자 상태조회, 아파트 매매 실거래가, 공휴일, 법령·판례

설치

• Claude Desktop: 릴리스의 .mcpb 파일을 열면 끝입니다 (공식 MCP Registry 등록).
• 그 외: 단일 Go 바이너리 또는 go install.
• API 키는 직접 발급한 무료 키를 씁니다. OpenDART 키 하나만 있어도 몇 분이면 시작할 수 있습니다.
• 내 컴퓨터에서만 실행되고, 제3자 서버나 텔레메트리가 없습니다.

키 발급 없이 URL만으로 쓰는 호스팅 버전도 준비 중입니다. 관심 있으시면 대기 명단에 남겨 주세요.
https://github.com/YoungsoonLee/korea-data-mcp/…

다음으로 넣을 데이터(한국은행 ECOS, KOSIS 등) 의견도 환영합니다.