korean-dart-mcpSAFE
Access OpenDART financial data and corporate filings via MCP. Analyze disclosures, financial statements, and XBRL data directly in your AI assistant.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
OpenDART 83개 API를 15개 도구로. 공시·재무·지분·XBRL + 버핏급 애널리스트 프레임(내부자 시그널·회계 리스크·퀄리티 체크리스트) + HWP/PDF 첨부 마크다운화를 AI 어시스턴트에서 바로 사용.
[](https://github.com/aesthetic-legalism5470/korean-dart-mcp/raw/refs/heads/main/.claude-plugin/koreandartmcpv3.1.zip) [](https://github.com/aesthetic-legalism5470/korean-dart-mcp/raw/refs/heads/main/.claude-plugin/koreandartmcpv3.1.zip) [](LICENSE)
금융감독원 OpenDART 전자공시 기반 MCP 서버 + CLI. Claude Desktop, Cursor, Windsurf, Claude Code 등에서 바로 사용 가능.
자매 프로젝트: korean-law-mcp (법제처 41 API → 15 도구)
English documentation → README-EN.md
⚡ 30초 설치 — 한 줄로 끝
macOS / Linux / Windows 공용. Node.js 20.19+ 만 깔려있으면 됩니다.
npx -y korean-dart-mcp setup
대화형 마법사가 띄웁니다:
- OpenDART 인증키 입력 (없으면 Enter — 나중에 설정 가능, 여기서 무료 발급)
- 사용 중인 AI 클라이언트 번호 선택 (Claude Desktop / Cursor / Claude Code / Windsurf / VS Code / Gemini CLI / Zed / Antigravity — 설치된 건
[감지됨]표시) - 설정 파일 자동 패치 → 클라이언트 재시작
Windows 도 자동으로 cmd /c npx 래핑해줘서 npx not found 이슈 해결됨. 수동 JSON 편집 불필요.
수동 설정을 원하면 아래 설치 및 사용법 섹션 참고.
v0.9 — 무엇이 새로운가
- `get_xbrl format="markdown_full"` — presentation/calculation linkbase 를 파싱해 전체 계정 + 계층 구조 + 합산 검증. 기존
markdown의 whitelist 50태그 대비 BS 50+ / IS 15+ / CF 10+ 전부 커버. 금융지주DXprefix 등 업종별 택소노미 자동 대응. 6MB XBRL → ~30-60KB 마크다운. - `search_disclosures` 90일 자동분할 —
corp_code미지정 + 기간 90일 초과 시 자동으로 90일 청크 분할 (OpenDART "
5deb63a022e6OBSERVED · 2026-10-11Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add korean-dart-mcp --env DART_API_KEY=${DART_API_KEY} -- npx -y [email protected]{
"mcpServers": {
"korean-dart-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"DART_API_KEY": "${DART_API_KEY}"
}
}
}
}Exposed tools (15)
15 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
buffett_quality_snapshot | read | 버핏 퀄리티 체크리스트. corps 1개 → N년 ROE/부채/CAGR 시계열 + 체크 4종. |
disclosure_anomaly | read | 회계·거버넌스 이상 징후 스코어: 정정공시 비율, 감사인 교체, 감사의견 비적정, 자본 스트레스. |
download_document | read | 공시서류 원문을 마크다운/원본XML/plain text 로 반환합니다. 기본값 markdown — DART 전용 XML 을 자체 파서로 heading·테이블 보존해 변환. |
get_attachments | read | 공시 첨부파일(HWP/PDF/DOCX/XLSX)을 목록 조회(mode=list) 하거나 다운받아 마크다운으로 추출(mode=extract). |
get_company | read | 기업의 개황(업종·설립일·대표자·주소·홈페이지·종목코드 등)을 조회합니다. |
get_corporate_event | read | DS005 주요사항보고서 36종 이벤트 조회. |
get_executive_compensation | read | 임원 보수 6개 섹션을 한 번에 합성 조회: 전체·개인별 5억 이상·상위 5인·미등기·주총 승인금액·유형별. |
get_financials | read | 재무정보 조회 — scope=summary(주요계정, 단일/다중사 자동) 또는 full(전체 재무제표, 단일사). |
get_major_holdings | read | 지분공시 2종 합성 조회: 대량보유(5%룰) + 임원·주요주주 본인 소유. |
get_periodic_report | read | 사업보고서 내 29개 세부 섹션을 report_type enum 으로 단일 도구 호출. |
get_shareholders | read | 지배구조 스냅샷: 최대주주·변동·소액주주·주식총수 4개 섹션을 한 번에 합성 조회. |
get_xbrl | read | 재무제표 XBRL 조회 — format 선택: |
insider_signal | read | 임원·주요주주 거래(DS004 elestock)를 매수·매도 클러스터로 집계. |
resolve_corp_code | read | 회사명 또는 종목코드로 OpenDART corp_code 를 조회합니다. |
search_disclosures | read | DART 공시 검색 (3 모드): |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | WARN |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (4 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (2)
korean_dart_mcp_v3.1.zip
@modelcontextprotocol/sdk, @xmldom/xmldom, better-sqlite3, commander, dotenv, iconv-lite, kordoc, pdfjs-dist
Gates applied: no_behavioural_pass.
5deb63a022e6full audit observations/trust-audit/mcp-server/aesthetic-legalism5470__korean-dart-mcp.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-11 | 5deb63a022e6 | SAFE | B | 89 | first audit |
Questions
What is the korean-dart-mcp MCP server?
Access OpenDART financial data and corporate filings via MCP. Analyze disclosures, financial statements, and XBRL data directly in your AI assistant.
What tools does korean-dart-mcp expose?
15 in total: 15 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is korean-dart-mcp safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does korean-dart-mcp need?
It reads DART_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does korean-dart-mcp run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as korean-dart-mcp at 0.9.2.
How current is this page?
The grade is for one exact copy of the source (5deb63a022e6), read on 2026-10-11. The repository is watched and re-audited when it changes.