Opendart MCP (opendart-mcp-server)

🇰🇷 OpenDART MCP服务器

面向AI代理的韩国企业公示数据-powered by 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 可以在免费发放（每天10000件）。

______________________________________________________________________

🔧 提供的工具

“工具”“说明”“输入示例” |------|------|----------| | search_company |企业搜索和基本信息查询| "삼성전자", "005930" | | search_disclosures |搜索公告报告| company: "카카오", type: "annual" | | get_financial_summary 查询主要财务数据（收入、营业利润、净利润等） company: "삼성전자", year: 2024 | | compare_financials |多家公司财务比较| companies: ["삼성전자", "SK하이닉스"] | | get_full_financial_statements |查看完整财务报表详细信息| company: "카카오", statement_type: "IS" |

______________________________________________________________________

💬 使用示例

“告诉我三星电子的基本信息”

삼성전자(주) (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건

“告诉我Kakao2023年的销售额和营业利润”

카카오 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": "발급받은_키"
      }
    }
  }
}

설정 파일 위치

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

소스 코드에서 직접 실행하는 경우

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

光标

光标设置→ MCP → 添加服务器：

{
  "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: 背 常规承诺 风格
3. console.log() 禁用（防止stdio传输污染）。 console.error()仅使用

______________________________________________________________________

📄 许可证

麻省理工学院 -可以自由使用、修改和分发。

该项目由金融监督院负责。 DART OpenAPI使用的公共数据。

______________________________________________________________________

英语

OpenDART MCP服务器

韩国企业为人工智能代理披露数据——由DART提供支持

连接韩国的MCP服务器 飞镖 （电子披露系统）到克劳德、ChatGPT和Cursor等人工智能代理。

问你的人工智能“三星电子的收入是多少？”并从韩国官方财务文件中得到真实的答案。

可用工具

快速开始

添加到您的Claude桌面 claude_desktop_config.json:

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

请访问获取免费DART API密钥 opendart.fs.or.kr.Corp代码数据在首次运行时自动下载。

许可证

麻省理工学院