opendart-mcp 0.1.0

OpenDART (DART 전자공시시스템) MCP Server - 금융감독원 공시정보 API

OpenDART MCP Server

금융감독원 DART 전자공시시스템 Open API를 MCP(Model Context Protocol) 서버로 제공합니다.

Claude, ChatGPT 등 MCP를 지원하는 AI 클라이언트에서 한국 상장기업의 공시정보, 재무제표, 지분공시 등 83개 API를 자연어로 조회할 수 있습니다.

사전 준비

OpenDART에서 API 인증키를 발급받으세요.

설치 및 설정

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "opendart": {
      "command": "uvx",
      "args": ["opendart-mcp"],
      "env": {
        "OPENDART_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

설정 파일 위치: macOS ~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code

claude mcp add opendart -- uvx opendart-mcp

# API 키 설정
export OPENDART_API_KEY="<YOUR_API_KEY>"

Cursor / Windsurf

MCP 설정 파일(.cursor/mcp.json 또는 .windsurf/mcp.json)에 추가:

{
  "mcpServers": {
    "opendart": {
      "command": "uvx",
      "args": ["opendart-mcp"],
      "env": {
        "OPENDART_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

SSE (원격 서버)

uvx opendart-mcp --transport sse --host 0.0.0.0 --port 8000

Docker

docker build -t opendart-mcp .
docker run -e OPENDART_API_KEY="<YOUR_API_KEY>" -p 8000:8000 opendart-mcp

제공 도구 (83개)

공시정보 (4개)

도구	설명
search_disclosure	공시 검색 (기업코드, 날짜, 공시유형 등으로 필터링)
get_company_info	기업 개황 조회
get_document	공시 원문 다운로드 (ZIP)
get_corp_code	전체 고유번호 목록 다운로드

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

도구	설명
get_stock_issuance_status	증자(감자) 현황
get_dividend_info	배당에 관한 사항
get_treasury_stock_status	자기주식 취득 및 처분 현황
get_largest_shareholder	최대주주 현황
get_largest_shareholder_change	최대주주 변동 현황
get_minority_shareholder	소액주주 현황
get_executive_status	임원 현황
get_employee_status	직원 현황
get_individual_compensation	개인별 보수지급 금액 (5억 이상)
get_total_compensation	이사·감사 전체의 보수현황
get_top5_compensation	개인별 보수지급 금액 (상위 5인)
get_investment_in_others	타법인 출자 현황
get_total_shares_status	주식 총수 현황
get_debt_securities_issued	채무증권 발행실적
get_commercial_paper_balance	기업어음증권 미상환 잔액
get_short_term_bond_balance	단기사채 미상환 잔액
get_corporate_bond_balance	회사채 미상환 잔액
get_new_capital_securities_balance	신종자본증권 미상환 잔액
get_contingent_capital_balance	조건부자본증권 미상환 잔액
get_auditor_opinion	회계감사인의 감사의견
get_audit_service_contract	감사용역 체결현황
get_non_audit_service_contract	비감사용역 체결현황
get_outside_director_status	사외이사 및 그 변동현황
get_unregistered_exec_compensation	미등기임원 보수현황
get_total_compensation_approval	이사·감사의 보수한도 승인현황
get_compensation_by_type	유형별 보수지급 금액
get_public_offering_fund_usage	공모자금의 사용내역
get_private_placement_fund_usage	사모자금의 사용내역

재무정보 (7개)

도구	설명
get_single_company_accounts	단일회사 주요계정
get_multi_company_accounts	다중회사 주요계정
get_xbrl_document	재무제표 원본파일 (XBRL ZIP)
get_full_financial_statement	단일회사 전체 재무제표
get_xbrl_taxonomy	XBRL 택사노미 재무제표 양식
get_single_financial_index	단일회사 주요 재무지표
get_multi_financial_index	다중회사 주요 재무지표

지분공시 (2개)

도구	설명
get_major_stockholding	대량보유 상황보고
get_executive_stockholding	임원·주요주주 소유보고

주요사항보고서 (36개)

도구	설명
get_asset_transfer_putback	자산양수도(풋백옵션)
get_default_occurrence	채무불이행(파산)
get_business_suspension	영업정지
get_rehabilitation_filing	회생절차 개시신청
get_dissolution_event	해산사유 발생
get_paid_capital_increase	유상증자 결정
get_free_capital_increase	무상증자 결정
get_mixed_capital_increase	유무상증자 결정
get_capital_reduction	감자 결정
get_creditor_management_start	채권은행 관리절차 개시
get_lawsuit_filing	소송 등의 제기
get_overseas_listing_decision	해외 상장 결정
get_overseas_delisting_decision	해외 상장폐지 결정
get_overseas_listing	해외 상장
get_overseas_delisting	해외 상장폐지
get_convertible_bond_decision	전환사채권 발행결정
get_bond_with_warrant_decision	신주인수권부사채권 발행결정
get_exchangeable_bond_decision	교환사채권 발행결정
get_creditor_management_stop	채권은행 관리절차 중단
get_contingent_bond_decision	조건부자본증권 발행결정
get_treasury_stock_acquisition_decision	자기주식 취득 결정
get_treasury_stock_disposal_decision	자기주식 처분 결정
get_treasury_trust_contract_decision	자기주식취득 신탁계약 체결 결정
get_treasury_trust_termination_decision	자기주식취득 신탁계약 해지 결정
get_business_acquisition_decision	영업양수 결정
get_business_transfer_decision	영업양도 결정
get_tangible_asset_acquisition_decision	유형자산 양수 결정
get_tangible_asset_transfer_decision	유형자산 양도 결정
get_other_corp_stock_acquisition_decision	타법인 주식 양수 결정
get_other_corp_stock_transfer_decision	타법인 주식 양도 결정
get_stock_bond_acquisition_decision	주권 관련 사채권 양수 결정
get_stock_bond_transfer_decision	주권 관련 사채권 양도 결정
get_merger_decision	회사합병 결정
get_division_decision	회사분할 결정
get_division_merger_decision	회사분할합병 결정
get_stock_exchange_transfer_decision	주식교환·이전 결정

증권신고서 (6개)

도구	설명
get_equity_securities_reg	지분증권
get_debt_securities_reg	채무증권
get_depositary_receipts_reg	증권예탁증권
get_merger_reg	합병
get_stock_exchange_reg	주식의 포괄적 교환·이전
get_division_reg	분할

주요 파라미터

파라미터	설명	예시
corp_code	기업 고유번호 (8자리)	00126380 (삼성전자)
bsns_year	사업연도	2024
reprt_code	보고서 코드	11013 1분기, 11012 반기, 11014 3분기, 11011 사업보고서
bgn_de / end_de	조회 시작일 / 종료일 (YYYYMMDD)	20240101 / 20241231
rcept_no	접수번호 (14자리)	20240312000736

corp_code를 모를 경우 search_disclosure로 기업명 검색하거나 get_corp_code로 전체 목록을 조회할 수 있습니다.

사용 예시

MCP 클라이언트(Claude 등)에서 자연어로 질문하면 됩니다:

• "삼성전자 2024년 사업보고서에서 배당 정보 알려줘"
• "네이버 최대주주 현황 조회해줘"
• "2024년 삼성전자 자기주식 취득 결정 내역 보여줘"
• "SK하이닉스 2024년 재무제표 주요계정 조회"
• "카카오 임원 현황이랑 보수 정보 알려줘"

라이선스

MIT