金融数据API服务

OpenDART MCP服务器🇰🇷

提供韩国金融监督院电子公示系统（DART）API作为模型上下文协议（MCP）的服务器。

AI助手可以实时查询韩国上市企业的公告、财务信息、企业信息。

📅 支持数据：2023年至2025年最新（第三季度）均可查询！

🎬 演示视频

🎥 点击即可在YouTube上观看演示视频！

主要功能（14种工具）

🔍 企业搜索

📋 公告/公司信息

💰 财务信息

👥 人员信息

📈 股份信息

💵 资本/股票信息

🚀 快速入门

方法1：使用已部署的服务器（建议）

无需另行设置即可使用！

https://dart-mcp-self.vercel.app/sse

只需将上述URL添加到MCP客户端即可！

方法2：直接部署Vercel

Fork后连接Vercel时自动分发。

方法3:本地运行

git clone https://github.com/Dayoooun/dart-mcp.git
cd dart-mcp

# 의존성 설치 및 실행
pip install -e .
opendart-mcp

配置MCP客户端

光标IDE

~/.cursor/mcp.json 添加到文件：

{
  "mcpServers": {
    "opendart": {
      "type": "http",
      "url": "https://dart-mcp-self.vercel.app/sse"
    }
  }
}

克劳德桌面版

claude_desktop_config.json添加到：

{
  "mcpServers": {
    "opendart": {
      "url": "https://dart-mcp-self.vercel.app/sse"
    }
  }
}

本地运行时（stdio）

{
  "mcpServers": {
    "opendart": {
      "command": "opendart-mcp"
    }
  }
}

📖 使用示例

💡 核心：按企业名称搜索

不知道corp_code也可以！ find_company通过搜索：

“给我看一张叫仁山街的公司财务报表”

AI自动：

1. find_company("인산가") →获得corp_code
2. get_financial_account(corp_code=...) →查询财务信息

默认使用

"삼성전자 기업 정보 알려줘"
"네이버의 2023년 연간 재무제표 보여줘"
"카카오 직원 현황과 평균 급여 알려줘"

查询不熟悉的企业

"오르비텍이라는 회사의 직원 현황 알려줘"
"나노씨엠에스 임원 현황 보여줘"
"두산로보틱스 재무정보 조회해줘"

支持同时搜索英文/韩文

"NAVER 재무정보" → 네이버 찾음
"네이버 재무정보" → NAVER 찾음
"LG 계열사 목록" → LG전자, LG화학, LG에너지솔루션 등 찾음

🏢 主要企业唯一编号

对于常用的大型企业，可以直接使用corp_code：

公司名称corp_code项目代码 |--------|-----------|----------| 三星电子00126380005930 SK海力士00164779 000660 LG电子00401731 066570 现代汽车00164742 005380 NAVER 00266961 035420 | Kakao 00258801 035720 三星SDI00126371006400 LG化学00356361 051910 赛特瑞恩00421045 068270 浦项制铁控股00126186005490

其他企业: find_company请用搜索！（支持114951家企业）

📋 API参数指南

报告代码（reprt_code）

区分财务报表（fs_div）

值说明 |----|------| | CFS |合并财务报表（包括子公司，通常使用）| | OFS |个人财务报表（仅适用于法人）|

市场划分（corp_cls）

值说明 |----|------| Y|有价证券市场（KOSPI） KKOSDAQ市场 |N| KONEX市场| |E|其他（非上市等）|

财务指标分类代码（idx_cl_code）

get_financial_index 在API中使用 （必需）:

🔧 find_company详细信息

按企业名称搜索corp_code。 114951家企业 立即从数据中检索！

特性：

• 🚀 快速搜索（~50 ms）-使用预加载的数据
• 🔄 韩文/英文同时搜索-搜索“NAVER”时也可以搜索“NAVER”
• 上市企业优先排序

请求：

{
  "query": "네이버"
}

回复：

{
  "status": "000",
  "companies": [
    {
      "corp_code": "00266961",
      "corp_name": "NAVER",
      "stock_code": "035420"
    },
    {
      "corp_code": "01246715",
      "corp_name": "네이버랩스",
      "stock_code": ""
    }
  ]
}

🛠️ 开发

项目结构

dart-mcp/
├── api/
│   ├── index.py          # Vercel 서버리스 함수 (SSE)
│   └── companies.json    # 기업 데이터 (114,951개)
├── scripts/
│   └── update_companies.py  # 기업 데이터 업데이트 스크립트
├── src/opendart_mcp/
│   ├── server.py         # MCP 서버 핵심 로직
│   ├── api/              # API 모듈
│   └── models/           # Pydantic 모델
├── vercel.json           # Vercel 설정
└── pyproject.toml        # 패키지 설정

本地开发

# uv 사용 (권장)
uv sync
uv run opendart-mcp

# 또는 pip 사용
pip install -e ".[dev]"
opendart-mcp

企业数据更新

find_company表示 api/companies.json 使用文件。新公司注册后，建议每月更新一次：

# 기업 데이터 업데이트 (114,000+ 기업)
python scripts/update_companies.py

# 변경사항 배포
git add api/companies.json
git commit -m "Update companies data"
git push

🤝 贡献

欢迎您的贡献！

1. 分叉
2. 创建Feature branch（git checkout -b feature/amazing-feature)
3. 承诺(git commit -m 'Add amazing feature')
4. 推(git push origin feature/amazing-feature)
5. 拉取请求

📄 许可证

MIT许可证-可自由使用、修改和分发。

🔗 相关链接

• OpenDART官方网站
• OpenDART API文档
• MCP（模型上下文协议）

⭐ 星迹

如果这个项目有帮助的话，请点击“Star”！