mcp-opendart | 通往MCP之路

한국어 | English

MCP OpenDART

https://img.shields.io/github/license/ChangooLee/mcp-opendart

https://img.shields.io/pypi/v/mcp-opendart

https://img.shields.io/pypi/dm/mcp-opendart

MCP OpenDART 是一个为 OpenDART（韩国金融监督院电子公告系统）设计的 Model Context Protocol (MCP) 服务器。该集成在确保数据隐私和安全的同时，实现了与 OpenDART 的安全且上下文感知的 AI 交互。

使用示例

您可以向 AI 助手发出以下请求：

📊 财务报告 - "请获取三星电子的最新季度报告"

🔍 公告搜索 - "查找上个月 KOSPI 企业的主要股权变动"

📈 企业分析 - "展示现代汽车过去三年的财务报表"

⚡ 实时更新 - "获取今天科技板块的重要公告"

功能演示

[演示视频即将发布]

支持功能

功能	支持状态	描述
公告信息	✅ 完全支持	企业信息、公告文档查询
定期报告主要信息	✅ 完全支持	业务报告、季度/半年度报告主要信息
定期报告财务信息	✅ 完全支持	财务报表、XBRL 数据
股权公告综合信息	✅ 完全支持	主要股东及高管股权现状
重要事项报告主要信息	✅ 完全支持	重要事项报告核心信息
证券申报书主要信息	✅ 完全支持	证券发行申报主要信息

快速入门指南

1. 认证设置

首先，获取 OpenDART API 密钥：

访问 OpenDART

注册并申请 API 密钥

2. 安装

Python 3.10+ 安装指南

检查 Python 版本 (需要 3.10 或更高版本)

python3 --version

如果 Python 版本低于 3.10，请按照以下指南安装 Python 3.10 或更高版本：

macOS

从官方网站下载最新 Python 安装文件: https://www.python.org/downloads/macos/

或使用 Homebrew:

安装后可能需要使用 python3.10 命令。

Windows

从官方网站下载并运行最新 Python 安装文件: https://www.python.org/downloads/windows/

安装时务必勾选 "Add Python to PATH" 选项。

安装后重启终端并使用 python 或 python3 命令。

Linux (Ubuntu/Debian)

更新包列表并安装 Python 3.10:

可能需要使用 python3.10 命令。

Linux (Fedora/CentOS/RHEL)

安装 Python 3.10:

IDE 集成

MCP OpenDART 设计用于与 AI 助手在 IDE 中集成使用。

Claude Desktop 设置方法

点击汉堡菜单 (☰) > Settings > Developer > 点击 "Edit Config" 按钮

添加以下配置:

[!NOTE]
YOUR_LOCATION: 替换为虚拟环境安装的实际路径
API-KEY: 替换为您获取的 OpenDART API 密钥

主要环境变量

OPENDART_API_KEY: OpenDART API 密钥

OPENDART_BASE_URL: API 基础 URL (默认: 官方 URL)

HOST: 服务器主机 (默认: 0.0.0.0)

PORT: 服务器端口 (默认: 8000)

TRANSPORT: 传输方式 (推荐 stdio)

LOG_LEVEL: 日志级别 (INFO, DEBUG 等)

MCP_SERVER_NAME: 服务器名称

工具

OpenDART 工具

ds001_disclosure: 公告信息搜索及查询

ds002_periodic: 定期报告主要信息查询

ds003_financial: 定期报告财务信息查询

ds004_ownership: 股权公告综合信息查询

ds005_major: 重要事项报告主要信息查询

ds006_securities: 证券申报书主要信息查询

类别	工具
公告信息	`get_corporation_code_by_name`, `get_disclosure_list`, `get_corporation_info`, `get_disclosure_document`, `get_corporation_code`
定期报告主要信息	`get_annual_report`, `get_quarterly_report`, `get_semi_annual_report`
定期报告财务信息	`get_single_acnt`, `get_multi_acnt`, `get_xbrl_file`, `get_single_acc`, `get_xbrl_taxonomy`, `get_single_index`, `get_multi_index`
股权公告综合信息	`get_major_shareholders`, `get_executive_holdings`
重要事项报告主要信息	`get_major_reports`, `get_business_reports`
证券申报书主要信息	`get_securities_filing`, `get_prospectus`