한국 DART MCP 설치·사용법 — 금융감독원 OpenDART 전자공시 83개

Korean DART MCP를 설치하면 Claude나 Cursor에서 자연어 한 줄로 금융감독원 전자공시(DART)의 재무제표·사업보고서·공시 목록을 바로 가져올 수 있습니다. OpenDART의 83개 API를 15개 도구로 압축해 제공하므로, API 사용법을 몰라도 “삼성전자 최근 3개년 영업이익 비교해줘” 같은 자연어 질문만으로 실제 공시 데이터에 기반한 분석을 받을 수 있습니다. 이 가이드는 API 키 발급부터 설치, 활용 프롬프트, 흔한 오류 해결까지 한 번에 다룹니다.

왜 DART MCP가 필요한가

금융감독원 전자공시시스템(DART)은 국내 상장·비상장 기업의 사업보고서, 분·반기보고서, 주요사항보고서, 감사보고서 등 방대한 공시를 무료로 개방하고 있습니다. OpenDART API를 직접 호출하려면 HTTP 요청 구성, 기업코드 매핑, JSON 파싱 등 상당한 구현이 필요합니다.

Korean DART MCP는 이 작업을 대신합니다. AI 클라이언트와 OpenDART 사이에서 자연어를 API 호출로 변환하고, 결과를 사람이 읽기 좋은 형태로 돌려줍니다. 투자 분석, 경쟁사 재무 비교, 공시 모니터링 등 다양한 업무에서 수작업을 크게 줄일 수 있습니다.

사용자(자연어)
    │
    ▼
Claude / Cursor
    │  MCP 프로토콜
    ▼
Korean DART MCP 서버 (15개 도구)
    │  HTTP REST
    ▼
OpenDART API (금융감독원)
    │
    ▼
전자공시 데이터 (재무제표·공시·기업정보)

Korean DART MCP 서버 소개

항목	내용
프로젝트명	Korean DART MCP
GitHub	github.com/chrisryugj/korean-dart-mcp
설치 방식	npx (Node.js)
제공 도구 수	15개
연동 API	금융감독원 OpenDART (83개 엔드포인트)
API 키 필요 여부	필요 (무료 발급)
라이선스	오픈소스

finance 카테고리의 다른 MCP 서버도 함께 살펴보면 한국 금융 데이터 분석 환경을 더 풍부하게 구성할 수 있습니다.

준비물

설치를 시작하기 전에 아래 항목을 준비하세요.

• Node.js 18 이상: node -v 로 확인. 없으면 nodejs.org에서 설치
• npx: Node.js 설치 시 함께 포함됨
• OpenDART API 키: 아래 1단계에서 발급
• Claude Desktop 또는 Claude Code, Cursor: MCP를 지원하는 AI 클라이언트

단계별 설치 방법

1단계 — OpenDART API 키 발급

1. opendart.fss.or.kr 에 접속합니다.
2. 상단 메뉴에서 회원가입을 클릭하고 이메일·이름·기관 정보를 입력합니다.
3. 가입 후 로그인하여 인증키 신청/관리 메뉴로 이동합니다.
4. 사용 목적을 입력하고 신청하면 이메일 인증 후 40자리 API 키가 즉시 발급됩니다.
5. 발급된 키를 안전한 곳에 보관합니다. 이 키는 외부에 노출하지 않도록 주의하세요.

OpenDART 키는 개인·기업 모두 무료로 신청할 수 있습니다. 일일 호출 한도가 있으므로 대량 조회 시 주의하세요.

2단계 — Node.js 환경 확인

node -v
# v18.0.0 이상이어야 합니다

npx -v
# 함께 출력되면 정상

Node.js가 없다면 nodejs.org에서 LTS 버전을 다운로드해 설치하세요.

3단계 — Claude Desktop에 서버 등록

Claude Desktop 사용자는 설정 파일(claude_desktop_config.json)을 열어 mcpServers 블록에 아래 내용을 추가합니다.

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "korean-dart-mcp": {
      "command": "npx",
      "args": ["-y", "korean-dart-mcp"],
      "env": {
        "DART_API_KEY": "여기에_40자리_키_입력"
      }
    }
  }
}

Claude Code 사용자는 ~/.claude/settings.json 의 mcpServers 블록에 동일한 내용을 추가합니다.

Cursor 사용자는 Settings → MCP 탭에서 위 JSON을 붙여넣거나, ~/.cursor/mcp.json 파일에 직접 작성합니다.

4단계 — 클라이언트 재시작 및 연결 확인

설정 파일을 저장한 뒤 AI 클라이언트를 완전히 종료하고 다시 시작합니다.

• Claude Code: 터미널에서 /mcp 명령을 입력하면 등록된 MCP 서버 목록과 상태가 표시됩니다. korean-dart-mcp가 connected 상태여야 합니다.
• Claude Desktop: 새 대화를 열고 입력창 아래에 도구 아이콘이 나타나면 연결 성공입니다.
• Cursor: Settings → MCP에서 korean-dart-mcp 옆 상태 표시가 초록색인지 확인합니다.

5단계 — 자연어 프롬프트로 전자공시 조회

연결이 완료되면 공시 데이터를 자연어로 바로 질의할 수 있습니다. 아래 예시를 그대로 입력해 보세요.

삼성전자의 최근 사업보고서에서 매출액, 영업이익, 당기순이익을 표로 정리해줘.

현대차와 기아의 작년 부채비율을 비교하고 어느 쪽이 재무 안정성이 높은지 분석해줘.

최근 한 달간 SK하이닉스가 제출한 공시 목록을 날짜순으로 알려줘.

네이버의 최근 3개년 영업이익 추이와 연평균 성장률(CAGR)을 계산해줘.

AI가 Korean DART MCP의 15개 도구 중 상황에 맞는 것을 자동으로 선택해 OpenDART API를 호출하고, 결과를 구조화해 돌려줍니다.

흔한 오류와 해결 방법

오류 메시지 / 증상	원인	해결 방법
DART_API_KEY 관련 오류	환경변수 미설정 또는 오타	설정 파일의 env.DART_API_KEY 값을 다시 확인
서버가 disconnected 상태	Node.js 미설치 또는 버전 낮음	node -v 확인 후 Node.js 18+ 설치
npx: command not found	Node.js 미설치	nodejs.org에서 Node.js 설치
호출 한도 초과 응답	OpenDART 일일 한도 초과	다음 날 다시 시도, 또는 조회 범위 축소
기업을 찾지 못함	유사 상호 여럿 존재	정확한 법인명 또는 종목코드를 함께 입력

설정 파일 JSON 형식 오류가 가장 흔한 원인입니다. JSON은 마지막 항목 뒤에 쉼표를 쓰면 파싱 오류가 납니다. 설정 파일 저장 전에 JSON 형식을 꼭 검증하세요.

관련 MCP 서버

Korean DART MCP와 함께 사용하면 한국 금융 데이터 분석 환경을 더 강력하게 만들 수 있는 서버들입니다.

한국 주식 MCP 서버

DART와 KRX 공식 API를 함께 활용하는 서버입니다. 주가 데이터와 재무제표를 결합한 종합 분석이 필요할 때 유용합니다.

npx -y korea-stock-mcp@latest

API 키는 동일하게 OpenDART 키를 사용합니다.

DART MCP 서버

Python(uvx) 환경 기반의 DART 연동 서버입니다. Python 프로젝트나 Jupyter 환경에서 AI와 함께 재무 분석을 수행하는 데 적합합니다.

uv --directory ~/Downloads/dart-mcp run dart.py

설치 전 GitHub(github.com/2geonhyup/dart-mcp)에서 리포지토리를 먼저 클론해야 합니다.

활용 팁

• 기업 특정: 동일·유사 상호가 여럿이라면 정확한 법인명 또는 종목코드를 함께 입력하면 정확도가 높아집니다.
• 출력 형식 지정: “표로 정리해줘”, “성장률 계산해서 보여줘” 처럼 출력 형식을 함께 지정하면 결과가 깔끔합니다.
• 연도 범위 좁히기: 대용량 비교 분석은 조회 연도와 기업 수를 명시적으로 좁혀야 호출 한도를 아낄 수 있습니다.
• 보고서 종류 지정: 사업보고서(연간), 분기보고서, 반기보고서 중 원하는 것을 명시하면 더 정확한 데이터를 받습니다.

자주 묻는 질문

Korean DART MCP는 무료로 사용할 수 있나요?

MCP 서버 자체는 오픈소스로 무료입니다. OpenDART API 키 역시 금융감독원에서 무료로 발급합니다. API 호출에는 일일 한도가 있으므로, 한도 초과 시 다음 날 다시 이용할 수 있습니다.

OpenDART API 키 발급에 얼마나 걸리나요?

이메일 인증을 완료하면 보통 수 분 내에 즉시 발급됩니다. 심사나 별도 대기 없이 신청 당일 사용할 수 있습니다.

83개 API가 15개 도구로 압축된다는 게 무슨 뜻인가요?

OpenDART의 83개 세부 엔드포인트를 Korean DART MCP가 재무제표 조회, 공시 검색, 기업 정보 조회 등 15개의 의미 단위 도구로 묶어 제공합니다. AI가 상황에 맞는 도구를 자동으로 선택하므로, 사용자는 어떤 API를 호출해야 할지 알 필요 없이 자연어로 질문만 하면 됩니다.

Claude Code와 Claude Desktop 중 어디에 설치해야 하나요?

두 환경 모두 지원합니다. Claude Desktop은 GUI 대화형 분석에 편리하고, Claude Code는 코드 작성·자동화 스크립트와 결합해 사용할 때 유용합니다. 설정 파일 경로만 다르며 설정 방법은 동일합니다.

Cursor에서도 사용할 수 있나요?

네, 가능합니다. Cursor의 Settings → MCP 탭에서 같은 npx 명령과 환경변수를 등록하거나, ~/.cursor/mcp.json 에 직접 작성하면 됩니다.

API 호출 한도를 초과하면 어떻게 되나요?

OpenDART API의 일일 한도를 초과하면 오류 응답이 반환됩니다. 대용량 분석 시 조회 범위(기간·기업 수)를 좁혀 한 번에 너무 많은 요청을 보내지 않도록 주의하세요. 한도는 다음 날 자정 이후 초기화됩니다.

다음 단계

Korean DART MCP를 설치했다면, finance 카테고리에서 한국 주식·채권·환율 등 다양한 금융 MCP 서버를 추가로 탐색해 보세요. MCP모아 서버 목록에서 업종별·기능별로 필터링해 내 워크플로에 맞는 서버를 찾을 수 있습니다.

새로운 한국형 MCP 서버를 발견했다면 MCP모아에 등록해 커뮤니티와 공유해 주세요.