韩国股票MCP
项目介绍
技术文档摘要
韩国股票 MCP 服务器
韩国股票分析用的 MCP 服务器。通过 DART（电子公告系统）和 KRX（韩国交易所）的官方 API，可以基于股价信息和公告资料进行 AI 分析。
🎯 主要功能
- 🔍 公告搜索 - 按公司、时间段搜索公告
- 📊 公告数据 - 提供解析过的公告报告原始文件数据
- 💼 财务报表分析 - 基于 XBRL 的详细财务数据
- 📈 股票数据 - KRX（KOSPI/KOSDAQ）每日股价信息及股票基本信息
⚡ 快速开始
1️⃣ 获取 API KEY
首先需要从 DART 和 KRX 获取 API KEY。
📝 获取 DART API KEY
- 注册：在 OPEN DART 注册
- 申请密钥：在 认证密钥申请页面 申请 API KEY
- 验证密钥：在 开放 API 使用状态 查看已发放的 API KEY
📈 获取 KRX API KEY
-
注册：在 KRX OPEN API 注册并登录
-
申请密钥：在我的页面 → API 认证密钥申请处申请
-
服务申请：批准后进入服务使用 → 股票菜单
-
API 使用申请：点击以下 6 项中的“API 使用申请”
- 有价证券每日交易信息
- 科斯达克每日交易信息
- 科内克斯每日交易信息
- 有价证券基本资料
- 科斯达克基本资料
- 科内克斯基本资料
⏱️ 大约需要 1 天时间批准。
-
验证密钥：批准后，在我的页面 → API 认证密钥发行历史中查看 API KEY
2️⃣ 设置 Claude Desktop
- 运行 Claude Desktop
- 点击 设置 → 开发者 → 编辑配置
- 在
claude_desktop_config.json文件中添加以下内容：
{
"mcpServers": {
"korea-stock-mcp": {
"command": "npx",
"args": ["-y", "korea-stock-mcp@latest"],
"env": {
"DART_API_KEY": "<YOUR_DART_API_KEY>",
"KRX_API_KEY": "<YOUR_KRX_API_KEY>"
}
}
}
}
- 重启：重启 Claude Desktop 应用设置
现在可以在 Claude 中开始分析韩国股票数据了。
可用工具
DART（电子公告系统）
-
get_disclosure_list - 公告搜索
- 按公告类型、公司、日期搜索公告报告
-
get_corp_code - 查询企业代码
- 提供 DART 注册公告公司的唯一编号、公司名称及股票代码
-
get_disclosure - 公告报告原文
- 通过 DART API 解析公告报告原始文件
-
get_financial_statement - 财务报表
- 上市公司及主要非上市公司 XBRL 财务报表
- 提供定期报告中的所有科目数据
KRX（韩国交易所）
-
get_stock_base_info - 股票基本信息
- KOSPI、KOSDAQ、KONEX 上市股票的基本信息
- 包括股票名称、股票代码、市场分类等基本信息
-
get_stock_trade_info - 每日交易信息
- KOSPI、KOSDAQ、KONEX 股票的每日交易数据
- 包括股价、成交量、市值等详细交易信息
-
get_market_type - 查询市场类型
- 根据股票代码查询该股票的市场类型（KOSPI/KOSDAQ/KONEX）
- 提供查询股票数据所需的市场信息
其他工具
- get_today_date - 查询今天日期
- 提供当前日期，格式为 YYYYMMDD
- 用于 AI 准确查询日期的工具
实际使用示例
📊 财务分析示例
提示："调查三洋食品 2023 年、2024 年 1 至 4 季度、2025 年 1 至 2 季度的销售额和营业利润，并检查增长率"
→ 查看三洋食品分析结果
提示："调查 APR 从 2023 年第 1 季度到 2025 年第 2 季度的销售额和营业利润增长情况，以及股价和市值趋势"
→ 查看 APR 分析结果
🏢 企业分析示例
提示："告诉我 HJ 中工是做什么赚钱的公司，并包括按业务部门的销售额"
→ 查看 HJ 中工分析结果
API 数据来源
- DART（电子公告系统）：上市公司的公告信息及财务报表
- KRX（韩国交易所）：股票基本信息及每日交易信息
贡献
欢迎贡献！请发送 Pull Request。
- 分叉此仓库
- 创建一个功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开 Pull Request
许可证
ISC 许可证
支持
- 🐛 如果遇到问题，请在 GitHub Issues 中登记
- ⭐ 如果觉得有用，请给个星！
免责声明
本工具仅供信息提供之用，并非投资建议。所有投资决策均由您自行负责。