penDART MCP - Korean corporate disclosure data for AI agents

🇰🇷 OpenDART MCP サーバー

AI エージェント向けの韓国企業の開示データ — DART 提供

DART（電子開示システム）のデータを AI に渡す最も簡単な方法です。

Claude Desktop、Cursor などの MCP 対応 AI に「サムスン電子の財務諸表を見せて」と伝えるだけで、すぐに回答が得られます。

⚡ クイックスタート

npm ですぐに使う（推奨）

npx opendart-mcp

Claude Desktop や Cursor の設定からすぐに使用できます。企業固有番号は初回実行時に自動でダウンロードされます。

ソースコードからインストール

git clone https://github.com/SongHyojun0228/opendart-mcp-server.git
cd opendart-mcp-server
npm install
npm run build && npm start

DART API キーは OpenDART から無料で発行できます（1日 10,000 件）。

🔧 提供するツール

💬 使用例

「サムスン電子の基本情報を教えて」

삼성전자(주) (SAMSUNG ELECTRONICS CO,.LTD)
────────────────────────────────────────
종목코드: 005930 (유가증권시장상장법인)
대표이사: 전영현, 노태문
법인구분: 유가증권시장상장법인
설립일: 1969-01-13
결산월: 12월
홈페이지: https://www.samsung.com/sec
주소: 경기도 수원시 영통구 삼성로 129 (매탄동)

「今日公開された開示情報はある？」

전체 공시 검색 결과 (2026-01-14 ~ 2026-02-13)
────────────────────────────────────────

[기타공시] 투자판단관련주요경영사항 (2026-02-13)
  https://dart.fss.or.kr/dsaf001/main.do?rcpNo=20260213801610
[주요사항] 주요사항보고서(유상증자결정) (2026-02-13)
  https://dart.fss.or.kr/dsaf001/main.do?rcpNo=20260213000234
...
총 847건

「カカオの 2023 年の売上高と営業利益を教えて」

카카오 2023년 연간 재무 요약 (연결)
────────────────────────────────────────
매출액         7조 5,570억원 (+11.2%)
영업이익        4,609억원 (-19.1%)
당기순이익       -1조 8,167억원 (-270.3%)
────────────────────────────────────────
자산총계        25조 1,800억원
부채총계        11조 3,214억원
자본총계        13조 8,586억원
────────────────────────────────────────
부채비율      81.7%

📦 詳細なインストールガイド

1. DART API キーを取得する

1. OpenDART にアクセス
2. 会員登録してログイン
3. 認証キーの申請 → API キーを取得（即時発行、無料）
4. 発行されたキーをコピーしておきます

2. プロジェクトをインストールする

git clone https://github.com/SongHyojun0228/opendart-mcp-server.git
cd opendart-mcp-server
npm install

3. 環境変数を設定する

cp .env.example .env

.env ファイルを開き、発行された API キーを入力します：

DART_API_KEY=여기에_발급받은_키_입력

4. 企業固有番号データをダウンロードする（任意）

npm run update-corp-codes

サーバーの初回起動時に自動でダウンロードされるため、この手順は任意です。手動で更新する場合にのみ実行してください。

5. ビルドして実行する

npm run build
npm start

⚙️ AI クライアントの設定

Claude Desktop（npx — 推奨）

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "opendart": {
      "command": "npx",
      "args": ["-y", "opendart-mcp"],
      "env": {
        "DART_API_KEY": "발급받은_키"
      }
    }
  }
}

{
  "mcpServers": {
    "opendart": {
      "command": "node",
      "args": ["/절대경로/opendart-mcp-server/dist/src/index.js"],
      "env": {
        "DART_API_KEY": "발급받은_키"
      }
    }
  }
}

Cursor

Cursor Settings → MCP → Add Server：

{
  "mcpServers": {
    "opendart": {
      "command": "npx",
      "args": ["-y", "opendart-mcp"],
      "env": {
        "DART_API_KEY": "발급받은_키"
      }
    }
  }
}

MCP Inspector（デバッグ）

npx @modelcontextprotocol/inspector node dist/src/index.js

🛠️ 開発への参加

# 빌드
npm run build

# 빌드 + 실행
npm run dev

# 기업 고유번호 업데이트
npm run update-corp-codes

# MCP Inspector로 테스트
npx @modelcontextprotocol/inspector node dist/src/index.js

プロジェクト構成

src/
├── index.ts              # FastMCP 서버 진입점
├── tools/
│   ├── disclosure.ts     # search_company, search_disclosures
│   └── financial.ts      # get_financial_summary, compare_financials, get_full_financial_statements
└── utils/
    ├── dart-client.ts    # DART API HTTP 클라이언트
    ├── corp-code.ts      # 회사명/종목코드 → 고유번호 변환
    └── formatters.ts     # 금액 포매팅 헬퍼

貢献方法

1. Fork → ブランチを作成 → コミット → PR
2. コミットメッセージは feat:、fix:、docs: など、Conventional Commits のスタイルに従います
3. console.log() の使用は禁止です（stdio 転送の汚染を防ぐため）。console.error() のみ使用してください

📄 ライセンス

MIT — 自由に使用、改変、配布できます。

このプロジェクトでは、金融監督院の DART OpenAPI の公開データを使用しています。

English

OpenDART MCP Server

AI エージェント向けの韓国企業の開示データ — DART 提供

韓国の DART（電子開示システム）と、Claude、ChatGPT、Cursor などの AI エージェントを接続する MCP サーバーです。

AI に「サムスン電子の売上高は？」と尋ねると、韓国の公式財務開示情報に基づく回答が得られます。

利用可能なツール

クイックスタート

Claude Desktop の claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "opendart": {
      "command": "npx",
      "args": ["-y", "opendart-mcp"],
      "env": {
        "DART_API_KEY": "your_api_key"
      }
    }
  }
}

無料の DART API キーは opendart.fss.or.kr から取得できます。企業コードデータは初回実行時に自動でダウンロードされます。

ライセンス

MIT