← 목록으로

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

요약
  • AI 에이전트가 한국 공공 API 데이터를 정확히 조회할 수 있도록 돕는 'korea-data-mcp' 서버가 개발됐다.
  • DART, 공공데이터포털, 국가법령정보 등의 API 응답에서 발생하는 오류와 함정을 서버에서 직접 보정하여 15개의 툴을 제공한다.

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 등) 의견도 환영합니다.

그냥 목록으로
원문 보기 ↗