OpenDART MCP Server
Enables Claude to access the Korean Financial Supervisory Service's OpenDART API for corporate filings, financial statements, and disclosures.
README
OpenDART MCP Server
한국 금융감독원 OpenDART API를 Claude에서 바로 사용할 수 있는 MCP(Model Context Protocol) 서버입니다.
API를 발급받아 Claude 커스텀 커넥터로 바로 연결할 수 있습니다.
Features
- Open DART API 전부 지원: Open DART에서 제공하는 API(83개)를 전부 지원합니다.
- Vercel 배포: ngrok/터널링 없이 커스텀 커넥터로 바로 연결 가능합니다.
- URL 기반 API 키: 커넥터 URL에 키를 포함하여 설정 없이 즉시 사용 가능합니다.
- 마크다운 출력: Claude에서 깔끔하게 렌더링되는 테이블 형태로 출력합니다.
- Corp Code 캐싱: 9만+ 기업 목록을 인메모리 캐싱 (24시간 TTL)
Quick Start
1. OpenDART API 키 발급
OpenDART에서 회원가입 후 API 인증키를 발급받으세요.
2. Claude에 연결
- claude.ai 접속
- 사용자 지정 > 커넥터 > 사용자 지정 커넥터 추가
- URL 입력:
https://your-project.vercel.app/api/mcp?opendart_key=YOUR_API_KEY - 연결 완료! 별도 설정 없이 바로 사용 가능
Tools
Config (2개)
| Tool | 설명 |
|---|---|
set_api_key |
OpenDART API 키를 세션에 설정 |
get_api_key_status |
API 키 설정 여부 확인 |
회사 검색 & 정보 (3개)
| Tool | 설명 |
|---|---|
opendart_search_company |
한글/영문 이름 또는 종목코드로 회사 검색 → corp_code 획득 |
opendart_get_company_info |
기업 개황 (대표이사, 주소, 업종 등) |
opendart_search_disclosure |
공시 검색 (기간, 유형, 페이지네이션) |
재무 정보 (7개)
| Tool | 설명 |
|---|---|
opendart_single_financial_accounts |
단일회사 주요계정 (매출, 영업이익, 자산 등) |
opendart_multi_financial_accounts |
다중회사 주요계정 비교 (최대 100개) |
opendart_full_financial_statement |
전체 재무제표 (BS, IS, CF 전 항목) |
opendart_single_financial_index |
단일회사 재무지표 (수익성, 안정성, 성장성) |
opendart_multi_financial_index |
다중회사 재무지표 비교 |
opendart_xbrl_taxonomy |
XBRL 표준 계정과목 분류 |
opendart_dividend_info |
배당 관련 정보 |
정기보고서 세부 항목 (24개)
| Category | Tools | 설명 |
|---|---|---|
| 주주 | 3 | 최대주주, 최대주주 변동, 소액주주 현황 |
| 임원/직원 | 3 | 임원 현황, 직원 현황, 사외이사 |
| 보수 | 5 | 개인별, 전체, 상위5인, 미등기임원, 승인총액 |
| 주식 | 3 | 발행주식총수, 증자/감자 현황, 자기주식 |
| 감사 | 3 | 감사의견, 회계감사 계약, 비감사 서비스 |
| 채무증권 | 5 | 발행실적, 기업어음, 단기사채, 회사채, 신종자본증권, 조건부자본증권 |
| 투자/자금 | 3 | 타법인 출자, 공모자금, 사모자금 사용내역 |
주주 보유 보고 (2개)
| Tool | 설명 |
|---|---|
opendart_major_stockholding |
대량보유 상황보고 (5% 이상) |
opendart_executive_stockholding |
임원/주요주주 보유 보고 |
주요사항보고서 (36개)
| Category | Tools | 설명 |
|---|---|---|
| 자본 변동 | 4 | 유상증자, 무상증자, 유무상증자, 감자 |
| 조직 변경 | 3 | 합병, 분할, 분할합병 |
| 영업/자산 양수도 | 7 | 영업양수, 영업양도, 유형자산 양수/양도, 타법인 주식 취득/처분, 자산양수도(풋백옵션) |
| 자기주식 | 5 | 취득, 처분, 신탁 체결, 신탁 해지, 주식교환/이전 |
| 사채 | 7 | 전환사채, 신주인수권부사채, 교환사채, 조건부자본증권, 주식관련사채 양수/양도, 주식배당 |
| 해외상장 | 4 | 상장/폐지 결정, 상장/폐지 현황 |
| 법률/경영 | 6 | 채권은행관리 개시/중단, 채무불이행, 소송, 영업정지, 회생절차, 해산 |
증권신고서 (6개)
| Tool | 설명 |
|---|---|
opendart_equity_securities_reg |
지분증권 신고서 |
opendart_debt_securities_reg |
채무증권 신고서 |
opendart_depositary_receipts_reg |
예탁증권 신고서 |
opendart_merger_reg |
합병 신고서 |
opendart_stock_exchange_reg |
주식교환 신고서 |
opendart_division_reg |
분할 신고서 |
Usage Examples
Claude에서 다음과 같이 사용하세요:
- "삼성전자의 20XX년 재무제표를 보여줘"
- "SK하이닉스의 최신 최대주주 현황을 알려줘"
- "카카오의 최근 공시 10개를 검색해줘"
- "현대자동차의 20XX년 임원 보수 현황을 보여줘"
- "LG에너지솔루션에 전환사채 발행 결정이 있었는지 확인해줘"
Tech Stack
- Runtime: Next.js 16 + TypeScript
- MCP: mcp-handler + @modelcontextprotocol/sdk
- Deploy: Vercel (Streamable HTTP, Seoul region 권장)
- ZIP: fflate (corp code XML 압축 해제)
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.