Korea Stock MCP

🚀 韩国股票MCP服务器

这是一个用于韩国股票分析的MCP服务器。借助DART（电子公示系统）和KRX（韩国交易所）的官方API，能够基于股价信息和公示资料开展AI分析。

🚀 快速开始

1️⃣ API密钥申请

首先，你需要获取DART和KRX的API密钥。

📝 DART API密钥申请

1. 注册账号：在 OPEN DART 完成注册。
2. 申请密钥：前往 认证密钥申请页面 申请API密钥。
3. 查看密钥：在 开放API使用情况 页面查看已发放的API密钥。

📈 KRX API密钥申请

1. 注册登录：在 KRX开放API 进行注册并登录。

2. 申请密钥：在“我的页面”→“API认证密钥申请”处提交申请。

3. 申请服务：审批通过后，进入“服务使用”→“股票”菜单。

4. 申请API使用：分别点击以下6个项目的“API使用申请”：

   • 有价证券每日交易信息
   • 科斯达克每日交易信息
   • 科涅克斯每日交易信息
   • 有价证券基本信息
   • 科斯达克基本信息
   • 科涅克斯基本信息

   ⏱️ 审批大约需要1天时间。

5. 查看密钥：审批通过后，在“我的页面”→“API认证密钥发放记录”中查看API密钥。

2️⃣ Claude Desktop配置

1. 启动 Claude Desktop。
2. 依次点击 设置 → 开发者 → 编辑配置。
3. 在 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>"
      }
    }
  }
}

4. 重启：重启Claude Desktop使配置生效。

现在，你可以使用Claude开始分析韩国股票数据了。

✨ 主要特性

• 🔍 公示搜索 - 支持按公司和时间段搜索公示信息。
• 📊 公示数据 - 提供对公示报告原始文件解析后的数据。
• 💼 财务报表分析 - 基于XBRL的详细财务数据。
• 📈 股票数据 - 提供KRX（科斯皮/科斯达克）的每日股价信息和股票基本信息。

💻 使用示例

📊 财务分析示例

提示：“调查三养食品2023年、2024年1 - 4季度以及2025年1、2季度的销售额、营业利润，并计算增长率”
→ 查看三养食品分析结果

提示：“调查APR从2023年1季度到2025年2季度的销售额、营业利润增长情况，以及股价和市值走势”
→ 查看APR分析结果

🏢 企业分析示例

提示：“告诉我HJ重工是如何盈利的，并提供各业务部门的销售额”
→ 查看HJ重工分析结果

📚 详细文档

可用工具

DART（电子公示系统）

1. get_disclosure_list - 公示搜索
   • 可按类型、公司和日期搜索公示报告。
2. get_corp_code - 企业代码查询
   • 提供DART注册公示公司的唯一代码、公司名称和股票代码。
3. get_disclosure - 公示报告内容
   • 通过DART API解析公示报告原始文件。
4. get_financial_statement - 财务报表
   • 提供上市公司和主要非上市公司的XBRL财务报表。
   • 提供定期报告中的所有账户数据。

KRX（韩国交易所）

1. get_stock_base_info - 股票基本信息
   • 提供科斯皮、科斯达克和科涅克斯上市公司的基本信息。
   • 包括股票名称、代码和市场分类等基本数据。
2. get_stock_trade_info - 每日交易信息
   • 提供科斯皮、科斯达克和科涅克斯股票的每日交易数据。
   • 包括股价、交易量和市值等详细交易信息。
3. get_market_type - 市场类型查询
   • 根据股票代码查询市场分类（科斯皮/科斯达克/科涅克斯）。
   • 为股票数据查询提供所需的市场信息。

其他工具

1. get_today_date - 今日日期查询
   • 以YYYYMMDD格式提供当前日期。
   • 为AI准确查询日期提供工具。

API数据源

• DART（电子公示系统）：上市公司公示信息和财务报表。
• KRX（韩国交易所）：股票基本信息和每日交易信息。

🔧 技术细节

贡献方式

欢迎你为项目做出贡献！请提交拉取请求。

1. 分叉此仓库。
2. 创建功能分支（git checkout -b feature/AmazingFeature）。
3. 提交更改（git commit -m 'Add some AmazingFeature'）。
4. 推送到分支（git push origin feature/AmazingFeature）。
5. 打开拉取请求。

免责声明

本工具仅用于信息提供，并非投资建议。所有投资决策由你自行负责。

📄 许可证

ISC许可证

支持

• 🐛 如果你遇到问题，请在GitHub问题中进行登记。
• ⭐ 如果你觉得本工具实用，请给它点个赞！