opendart_mcp

OpenDART API를 MCP 도구로 제공하는 서버

LLM(Claude, GPT 등)이 한국 기업의 공시정보, 재무제표, 지분공시 데이터에 직접 접근할 수 있게 합니다.

Features

83개 OpenDART API를 MCP 도구로 완전 지원합니다.

그룹	도구 수	설명
DS001 공시정보	4	공시검색, 기업개황, 공시서류원본, 고유번호
DS002 정기보고서 주요정보	28	증자/감자, 배당, 주주, 임원, 보수, 감사, 채무증권 등
DS003 재무정보	7	재무제표, 주요계정, XBRL, 재무지표
DS004 지분공시	2	대량보유 상황보고, 임원·주요주주 소유보고
DS005 주요사항보고서	36	증자/감자, M&A, 소송, 사채발행, 자사주 등
DS006 증권신고서	6	지분증권, 채무증권, 합병, 분할 등

Quick Start

1. API 키 발급

OpenDART에서 회원가입 후 인증키를 발급받으세요.

• OpenDART 로그인 후 인증키 발급 페이지에서 신청
• 발급 즉시 사용 가능 (관리자 승인 필요 없음)

2. 설치

dart pub global activate opendart_mcp

설치 후 opendart_mcp 명령어를 사용할 수 있습니다.

3. MCP 클라이언트 설정

Claude Desktop

claude_desktop_config.json 파일 위치:

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

다음 설정을 추가하세요:

{
  "mcpServers": {
    "opendart": {
      "command": "opendart_mcp",
      "env": {
        "OPENDART_API_KEY": "여기에_API_키_입력"
      }
    }
  }
}

Claude Desktop을 재시작하면 opendart 서버가 연결됩니다.

Claude Code

claude mcp add opendart -e OPENDART_API_KEY=여기에_API_키_입력 -- opendart_mcp

Cursor

설정 > MCP Servers에서 추가하거나, .cursor/mcp.json 파일을 직접 편집:

{
  "mcpServers": {
    "opendart": {
      "command": "opendart_mcp",
      "env": {
        "OPENDART_API_KEY": "여기에_API_키_입력"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json 파일에 다음 설정 추가:

{
  "mcpServers": {
    "opendart": {
      "command": "opendart_mcp",
      "env": {
        "OPENDART_API_KEY": "여기에_API_키_입력"
      }
    }
  }
}

기타 MCP 클라이언트

stdio transport를 지원하는 모든 MCP 클라이언트에서 사용 가능합니다.

명령어: opendart_mcp 환경변수: OPENDART_API_KEY

사용 예시

MCP 클라이언트에 연결 후 다음과 같이 질문할 수 있습니다:

공시 검색

• "삼성전자의 최근 공시를 검색해줘"
• "2024년 1월에 제출된 네이버의 사업보고서 찾아줘"

재무정보

• "SK하이닉스의 2024년 사업보고서 재무제표를 보여줘"
• "삼성전자와 SK하이닉스의 주요 재무지표를 비교해줘"
• "카카오의 2023년 손익계산서 주요 계정과목 알려줘"

주주 및 지분정보

• "네이버의 대량보유 주주 현황은?"
• "삼성전자 최대주주 변동현황 보여줘"

정기보고서 정보

• "삼성전자 2024년 배당 현황 알려줘"
• "LG에너지솔루션의 임원 현황을 보여줘"
• "카카오의 자기주식 취득 및 처분 현황은?"

주요사항보고서

• "네이버의 최근 유상증자 결정 내역 찾아줘"
• "삼성바이오로직스의 소송 제기 현황 보여줘"

API Coverage

전체 83개 API 상세 목록 보기

DS001 — 공시정보 (4개)

#	API	설명	지원
1	공시검색	공시 유형별, 회사별, 날짜별 조건으로 공시보고서 검색	✅
2	기업개황	DART에 등록된 기업 개황정보 제공	✅
3	공시서류원본파일	공시보고서 원본파일 다운로드	✅
4	고유번호	공시대상회사의 고유번호, 회사명, 종목코드 조회	✅

DS002 — 정기보고서 주요정보 (28개)

#	API	설명	지원
1	증자(감자) 현황	자본금 변동 정보	✅
2	배당에 관한 사항	배당 관련 정보	✅
3	자기주식 취득 및 처분 현황	자사주 거래 현황	✅
4	최대주주 현황	주요 주주 정보	✅
5	최대주주 변동현황	주주 구성 변화	✅
6	소액주주 현황	소규모 주주 정보	✅
7	임원 현황	임직원 구성	✅
8	직원 현황	직원 규모 정보	✅
9	이사·감사의 개인별 보수현황	5억원 이상 개인별 보수	✅
10	이사·감사 전체의 보수현황 (보수지급금액)	이사·감사 전체 보수지급금액	✅
11	개인별 보수지급 금액(5억이상 상위5인)	상위 5인 보수 상세	✅
12	타법인 출자현황	투자 현황	✅
13	주식의 총수 현황	발행주식 정보	✅
14	채무증권 발행실적	채무증권 발행 내역	✅
15	기업어음증권 미상환 잔액	기업어음 잔액	✅
16	단기사채 미상환 잔액	단기사채 잔액	✅
17	회사채 미상환 잔액	회사채 잔액	✅
18	신종자본증권 미상환 잔액	신종자본증권 잔액	✅
19	조건부 자본증권 미상환 잔액	조건부 자본증권 잔액	✅
20	회계감사인의 명칭 및 감사의견	감사 의견	✅
21	감사용역체결현황	감사 계약 현황	✅
22	회계감사인과의 비감사용역 계약체결 현황	비감사용역 계약	✅
23	사외이사 및 그 변동현황	사외이사 현황	✅
24	미등기임원 보수현황	미등기임원 보수	✅
25	이사·감사 전체의 보수현황 (주주총회 승인금액)	주주총회 승인 보수	✅
26	이사·감사 전체의 보수현황 (보수지급금액 - 유형별)	유형별 보수	✅
27	공모자금의 사용내역	공모 자금 사용	✅
28	사모자금의 사용내역	사모 자금 사용	✅

DS003 — 정기보고서 재무정보 (7개)

#	API	설명	지원
1	단일회사 주요계정	XBRL 재무제표의 주요계정과목 (재무상태표, 손익계산서)	✅
2	다중회사 주요계정	복수 대상법인 주요계정 비교 조회	✅
3	재무제표 원본파일(XBRL)	XBRL 형식 재무제표 원본파일	✅
4	단일회사 전체 재무제표	XBRL 재무제표의 모든 계정과목	✅
5	XBRL택사노미재무제표양식	IFRS 기반 표준계정과목체계	✅
6	단일회사 주요 재무지표	주요 재무지표 정보	✅
7	다중회사 주요 재무지표	복수 대상법인 주요 재무지표	✅

DS004 — 지분공시 종합정보 (2개)

#	API	설명	지원
1	대량보유 상황보고	주식등의 대량보유(5%+) 상황보고	✅
2	임원·주요주주 소유보고	임원·주요주주 특정증권등 소유상황	✅

DS005 — 주요사항보고서 주요정보 (36개)

#	API	설명	지원
1	자산양수도(기타), 풋백옵션	자산양수도 및 풋백옵션 정보	✅
2	부도발생	부도발생 주요 정보	✅
3	영업정지	영업정지 주요 정보	✅
4	회생절차 개시신청	회생절차 개시신청 정보	✅
5	해산사유 발생	해산사유 발생 정보	✅
6	유상증자 결정	유상증자 결정 정보	✅
7	무상증자 결정	무상증자 결정 정보	✅
8	유무상증자 결정	유무상증자 결정 정보	✅
9	감자 결정	감자 결정 정보	✅
10	채권은행 등의 관리절차 개시	채권은행 관리절차 개시 정보	✅
11	소송 등의 제기	소송 제기 정보	✅
12	해외 증권시장 주권등 상장 결정	해외시장 상장 결정	✅
13	해외 증권시장 주권등 상장폐지 결정	해외시장 상장폐지 결정	✅
14	해외 증권시장 주권등 상장	해외시장 상장	✅
15	해외 증권시장 주권등 상장폐지	해외시장 상장폐지	✅
16	전환사채권 발행결정	전환사채 발행 결정 정보	✅
17	신주인수권부사채권 발행결정	신주인수권부사채 발행 결정	✅
18	교환사채권 발행결정	교환사채 발행 결정	✅
19	채권은행 등의 관리절차 중단	채권은행 관리절차 중단 정보	✅
20	상각형 조건부자본증권 발행결정	조건부자본증권 발행 결정	✅
21	자기주식 취득 결정	자사주 취득 결정 정보	✅
22	자기주식 처분 결정	자사주 처분 결정 정보	✅
23	자기주식취득 신탁계약 체결 결정	자사주 신탁 체결 결정	✅
24	자기주식취득 신탁계약 해지 결정	자사주 신탁 해지 결정	✅
25	영업양수 결정	영업 양수 결정 정보	✅
26	영업양도 결정	영업 양도 결정 정보	✅
27	유형자산 양수 결정	유형자산 양수 결정	✅
28	유형자산 양도 결정	유형자산 양도 결정	✅
29	타법인 주식 및 출자증권 양수결정	타법인 주식 양수 결정	✅
30	타법인 주식 및 출자증권 양도결정	타법인 주식 양도 결정	✅
31	주권 관련 사채권 양수 결정	주권 관련 사채 양수 결정	✅
32	주권 관련 사채권 양도 결정	주권 관련 사채 양도 결정	✅
33	회사합병 결정	회사합병 결정 정보	✅
34	회사분할 결정	회사분할 결정 정보	✅
35	회사분할합병 결정	회사분할합병 결정 정보	✅
36	주식교환·이전 결정	주식교환·이전 결정 정보	✅

DS006 — 증권신고서 주요정보 (6개)

#	API	설명	지원
1	지분증권	증권신고서(지분증권) 요약 정보	✅
2	채무증권	증권신고서(채무증권) 요약 정보	✅
3	증권예탁증권	증권신고서(증권예탁증권) 요약 정보	✅
4	합병	증권신고서(합병) 요약 정보	✅
5	주식의포괄적교환·이전	증권신고서(주식의포괄적교환·이전) 요약 정보	✅
6	분할	증권신고서(분할) 요약 정보	✅

Development

프로젝트 개발 환경 설정:

# 의존성 설치
dart pub get

# 개발 모드 실행
OPENDART_API_KEY=your_key dart run bin/opendart_mcp.dart

# 테스트 실행
dart test

# 정적 분석
dart analyze

# 컴파일 (단일 실행파일)
dart compile exe bin/opendart_mcp.dart -o bin/opendart_mcp

License

CC BY-ND 4.0 — see LICENSE for details.