penDART MCP - Korean corporate disclosure data for AI agents

🇰🇷 OpenDART MCP Server

为 AI Agent 提供韩国企业公告数据——由 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 免费申请（每日 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건

“告诉我 Kakao 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 Agent 提供韩国企业公告数据——由 DART 提供支持

将韩国 DART（电子公告系统）接入 Claude、ChatGPT 和 Cursor 等 AI Agent 的 MCP 服务。

询问 AI“三星电子的营收是多少？”，即可获得来自韩国官方财务文件的真实答案。

可用工具

快速开始

将以下内容添加到 Claude Desktop 的 claude_desktop_config.json：

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

通过 opendart.fss.or.kr 免费获取 DART API 密钥。企业代码数据会在首次运行时自动下载。

许可证

MIT