AI 에이전트용 korea-data-mcp가 공개됐다. 이 프로젝트는 DART, 공공데이터포털, 국가법령정보 API를 하나의 MCP 서버로 묶어 Claude와 Cursor 같은 에이전트가 한국 기업·부동산·법령 데이터를 정확히 조회하도록 지원하는 것을 목표로 한다.
공공 API 응답에 숨어 있던 오독 함정
공공 API 응답을 AI 에이전트에 그대로 전달하면 형식적으로는 그럴듯해 보여도 잘못된 답이 나오는 경우가 있다. 대표 사례는 DART 반기보고서다. 삼성전자 2025년 상반기 매출을 묻는 질문에 74.6조라는 답이 나올 수 있는데, thstrm_amount가 반기 누적이 아니라 2분기 3개월치이기 때문이다. 실제 상반기 누적 매출은 153.7조로 제시됐다.
korea-data-mcp는 이런 문제를 서버 단계에서 처리하며, 현재 47개의 함정을 다루고 있다. 법령 조회에서는 현행 법령 본문에 아직 시행되지 않은 개정 조문이 섞이는 문제를 바로잡는다. 기준일에 시행 중인 버전을 고르고, 시행 예정 조문은 시행일과 함께 표시한다.
아파트 실거래가에서는 해제된 계약이 정상 거래에 포함되는 문제를 막는다. 기본적으로 해당 계약을 제외한 뒤 중앙값을 계산한다. 행정구역 개편으로 옛 지역 코드를 입력하면 지난달 데이터가 0건으로 반환되는 문제도 처리하며, 변경된 코드를 안내한다. 그 밖의 입력 오류, 만원 단위 금액, 2자리 연도 날짜도 별도로 다룬다. 전체 목록은 저장소의 docs/QUIRKS.ko.md에 정리됐다.
로컬 실행과 데이터 범위
지원 범위는 DART 기업·공시·재무제표, 주가, 기업 기본정보, 사업자 상태 조회와 아파트 매매 실거래가, 공휴일, 법령·판례까지다. Claude Desktop에서는 릴리스에 포함된.mcpb 파일을 열면 설치되며, 공식 MCP Registry에도 등록됐다. 그 밖의 환경에서는 단일 Go 바이너리나 go install 방식이 지원된다.
API 키는 사용자가 직접 발급한 무료 키를 사용한다. OpenDART 키 하나만 있어도 몇 분이면 시작할 수 있다. 서버는 개인 컴퓨터에서만 실행되며 제3자 서버나 텔레메트리를 사용하지 않는다. 키 발급 없이 URL만으로 이용할 수 있는 호스팅 버전은 준비 중이다.
korea-data-mcp의 의미는 한국 공공 API를 AI 에이전트에 연결하는 데서 한 단계 나아간다는 데 있다. 원시 응답을 보여주는 대신 기간·계약 상태·행정구역·법령 시행 시점처럼 오답을 만드는 조건을 서버가 선별하는 방식이다. 개발자는 다음 데이터로 한국은행 ECOS와 KOSIS 등을 검토하고 있으며, 관련 의견을 모으고 있다. 자세한 내용은 GitHub 저장소에서 확인할 수 있다.
참고 원문
이 기사는 다음 원문을 확인해 작성했습니다: geeknews — Show GN: korea-data-mcp – AI 에이전트가 한국 공공 API를 틀리게 읽지 않도록 해주는 MCP 서버
