chrisryugj/korean-dart-mcp
View on GitHub ↗OpenDART 전자공시MCP | 83개 API → 15 MCP 도구. 공시·재무·지분·XBRL + 버핏급 애널리스트 프레임(내부자 시그널·회계 리스크·퀄리티 체크리스트) + HWP/PDF 첨부 마크다운화 | 83 Korean DART disclosure APIs → 15 MCP tools with Buffett-grade analyst frames
92 ★15 forksTypeScriptUpdated 1mo ago
What you need to know
Node.js MCP server that compresses Korea's DART (OpenDART electronic disclosure) 83 APIs into 15 LLM-native tools with analyst frames and HWP/PDF-to-markdown.
Install
npx -y korean-dart-mcp setup npm install -g korean-dart-mcp /plugin marketplace add chrisryugj/korean-dart-mcp
Usage
- •"삼성전자 최근 분기 매출·영업이익, 전년 동기 대비 변화"
- •"최근 30일 자기주식 취득 결정한 상장사 전부"
- •"삼성전자 임원 거래 최근 2년 매수/매도 클러스터 분석"
- •"카카오 최근 3년 회계 리스크 스코어"
Key features
- ✓83 DART APIs compressed into 15 tools (search_disclosures, get_xbrl, get_financials, download_document, get_attachments)
- ✓Analyst frames: insider_signal, disclosure_anomaly 0-100 score, buffett_quality_snapshot
- ✓Company name auto-resolution via preloaded SQLite FTS (korean/stock-code/corp_code)
- ✓HWP/HWPX/PDF/DOCX/XLSX attachments to markdown via kordoc engine
- ✓XBRL presentation/calculation linkbase parsing with calculation verification (markdown_full)
- ✓22 disclosure presets and 90-day auto-chunking for market-wide searches
- ✓ZIP slip/bomb defense and page parallelization
Best for
Retail investors and analysts who want to query published Korean corporate disclosures through an AI assistant in natural language
Caveats
- ⚠Requires a free OpenDART API key (DART_API_KEY, 20,000 requests/day)
- ⚠Endpoint 1:1 coverage is narrower than 83-tool Python MCP alternatives
- ⚠Research aid only, not investment advice; the ecosystem is still early
- ⚠First run downloads an ~116K-company dump (~5-10s) for company-name resolution
Platforms: macOS · Linux · WindowsClients: Claude Desktop · Claude Code · Cursor · Windsurf · VS Code · Gemini CLI · Zed · Antigravity
Documentation ↗Reviewed 2026-08-11
Topics
- Stars
- 92★
- Forks
- 15
- Language
- TypeScript
- License
- MIT
- Created
- 2026-04-17
- Last push
- 2026-07-30