Korea DART MCP

OpenDART 공시 원문을 표 구조 보존 상태로 가져오는 5-tool MCP 서버입니다.

이 서버는 데이터 파이프만 담당합니다. 분석, 가공, 비교, 투자 판단은 MCP가 하지 않고 LLM이 원문과 구조화 데이터를 직접 읽고 수행합니다.

Tools

| Tool | Purpose | |---|---| | find_company | 회사명, 종목코드, corp_code로 회사를 찾고 상장 여부와 structured financial API 사용 가능 여부를 반환 | | search_disclosures | 회사/기간/공시유형 A~J/프리셋 기준 공시 목록 검색. 프리셋이 없으면 지정 kind 전체 반환 | | read_disclosures | DART document.xml 원문을 markdown, raw, toc로 읽기. Markdown은 표 구조를 보존 | | read_attachment | DART 뷰어 첨부파일 목록 조회 및 HWP/PDF/DOCX/XLSX 첨부를 Markdown으로 추출 | | get_financials | 상장사 structured 재무제표 조회. detail=summary/full, fs_div=CFS/OFS 지원 |

Design

• 회사명은 CorpCodeResolver가 OpenDART corpCode.xml 덤프를 SQLite 캐시에 적재해 자동 해결합니다.
• 공시 원문은 upstream의 DART XML parser를 사용해 heading과 table을 Markdown으로 변환합니다.
• 큰 사업보고서는 read_disclosures(format="toc")로 목차를 먼저 보고, section_id, section_title, query로 필요한 섹션/검색 excerpt만 가져오면 빠릅니다.
• 첨부파일은 DART viewer HTML에서 dcm_no와 download links를 찾아 kordoc으로 Markdown 추출합니다.
• 비상장 회사의 재무제표는 get_financials가 아니라 search_disclosures와 read_disclosures/read_attachment로 감사보고서 원문을 읽는 흐름입니다.
• XBRL/정기보고서/지분/이벤트/리스크/퀄리티 같은 합성·분석 wrapper는 노출하지 않습니다.

Install

npm install
npm run build

Run

DART_API_KEY가 필요합니다.

$env:DART_API_KEY="YOUR_OPEN_DART_KEY"
npm start

MCP 클라이언트에서는 build/index.js를 stdio 서버로 등록하세요.

Notes

• OpenDART API key: https://opendart.fss.or.kr/
• OpenDART 일일 호출 한도는 키 기준 20,000건입니다.
• corp code 캐시 기본 경로는 ~/.korea-dart-mcp/corp_code.sqlite입니다.

Credits

원작자 chrisryugj/korean-dart-mcp를 fork해 이어받았습니다. (MIT License)