korea-stock-mcp

Korea Stock MCP Server

🇰🇷 한국어 | 🇺🇸 English

🚀 Korea Stock MCP 将在开源 MCP 的基础上更进一步。 我们正在准备一项新服务，基于准确的韩国股票数据，帮助 AI 提供更可靠的回答。了解新服务的方向。

用于韩国股票分析的 MCP 服务。
通过 DART（电子公示系统）和 KRX（韩国交易所）官方 API，可基于股价信息和公告资料进行 AI 分析。

💬 欢迎提出改进建议和反馈！ 如果您在使用过程中遇到不便，或有改进想法，欢迎随时发送邮件。 我们会尽快查看并采纳。 📧 [email protected]

🎯 主要功能

• 🔍 公告搜索 - 按公司、时间段搜索公告
• 📊 公告数据 - 提供解析公告报告原始文件后得到的数据
• 💼 财务报表分析 - 基于 XBRL 的详细财务数据
• 📈 股票数据 - KRX（KOSPI/KOSDAQ）每日股价信息、证券基本信息

⚡ 快速开始

1️⃣ 获取 API KEY

首先需要获取 DART 和 KRX 的 API KEY。

📝 获取 DART API KEY

1. 注册：OPEN DART 注册
2. 申请密钥：在认证密钥申请页面申请 API KEY
3. 查看密钥：在开放 API 使用情况查看已发放的 API KEY

📈 获取 KRX API KEY

1. 注册：在 KRX OPEN API 注册并登录

2. 申请密钥：前往“我的页面” →“API 认证密钥申请”进行申请

3. 申请服务：获批后，前往“服务使用” →“股票”菜单

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

   • 有价证券每日交易信息
   • KOSDAQ 每日交易信息
   • KONEX 每日交易信息
   • 有价证券证券基本信息
   • KOSDAQ 证券基本信息
   • KONEX 证券基本信息

   ⏱️ 审批约需 1 天。

5. 查看密钥：获批后，前往“我的页面” →“API 认证密钥发放记录”查看 API KEY

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 中开始分析韩国股票数据。

处理大型公告文档

部分公告报告（如年度报告、季度报告等）是数 MB 的大型 XML 文档。 如果一次性处理这类文档的全部内容，可能会超出 AI 响应上限或导致错误。

如何运作？

系统会根据文档大小自动切换处理方式。

• 小型文档（小于 1 MB）：直接返回完整文档。
• 大型文档（1 MB 及以上）：先返回目录（TOC），而不是完整文档。Claude 会查看目录，自动选择与问题相关的章节并获取内容。

用户指南

无需进行任何额外操作。 Claude 会自动处理大型文档。

文档较大时，Claude 会自动执行以下操作：

1. 查看文档目录。
2. 自动选择与问题相关的章节并查询内容。
3. 回答后会提示剩余章节列表，因此您可以继续请求其他感兴趣的章节。

示例：

• “告诉我年度报告中的销售情况” → Claude 自动选择与销售相关的章节
• “也查询刚才目录中的第 3 节” → 可以直接请求特定章节

💡 复杂问题请分步骤提问

如果无法一次获得想要的答案，可以将问题拆分成多个步骤，以获得更准确的结果。

例如，如果一次无法回答“告诉我 Inventera 的证券申报文件中面向外国投资者的配售详情”：

1. “告诉我 Inventera 的唯一编号（corp_code）”
2. “显示该公司的证券发行相关公告列表”
3. “获取该公告正文”
4. “查找面向外国投资者的配售详情”

通过这种分步骤的方式，您可以逐步查看每个步骤的结果，最终找到所需信息。

---

可用工具

DART（电子公示系统）

1. get_disclosure_list - 公告搜索

   • 按公告类型、公司、日期搜索公告报告

2. get_corp_code - 查询唯一编号

   • 提供在 DART 注册的公告对象公司的唯一编号、公司名称和证券代码
   • 可通过公司名称（corp_name）或证券代码（stock_code）查询
   • 公司名称搜索失败时，会提示使用证券代码重试

3. get_disclosure - 公告报告原文

   • 通过 DART API 解析公告报告原始文件
   • 对于大型文档，会返回目录，并可通过 section_id 查询特定章节

4. get_financial_statement - 财务报表

   • 提供上市公司和主要非上市公司的 XBRL 财务报表
   • 提供定期报告中的所有会计科目数据

KRX（韩国交易所）

1. get_stock_base_info - 证券基本信息

   • KOSPI、KOSDAQ、KONEX 上市证券的基本信息
   • 证券名称、证券代码、市场类别等基本数据

2. get_stock_trade_info - 每日交易信息

   • KOSPI、KOSDAQ、KONEX 各证券的每日交易数据
   • 股价、交易量、市值等详细交易信息

3. get_market_type - 查询市场类别

   • 根据证券代码查询该证券所属的市场类别（KOSPI/KOSDAQ/KONEX）
   • 提供查询股票数据所需的市场信息

其他工具

1. get_today_date - 查询今天的日期
   • 以 YYYYMMDD 格式提供当前日期
   • 用于让 AI 准确查询日期的工具

实际使用示例

📊 财务分析示例

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

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

🏢 企业分析示例

提示词：“告诉我 HJ 重工业是做什么来赚钱的公司，以及各业务部门的销售额”
→ 查看 HJ 重工业分析结果

📑 公告分析示例

提示词：“获取 IPO（例如 Inventera / 0007J0）的外国投资者配售详情” → 查看 Inventera IPO 外国投资者配售分析结果

API 数据源

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

本地开发与测试

介绍修改源代码后立即进行测试的方法。

1️⃣ 安装依赖项

npm install

2️⃣ 设置环境变量

在项目根目录中创建 .env 文件：

DART_API_KEY=your_dart_api_key
KRX_API_KEY=your_krx_api_key

3️⃣ 运行 MCP Inspector

npm run inspect

在浏览器中打开终端输出的地址（例如 http://localhost:6274），即可打开 MCP Inspector UI。

在 Inspector 中点击 Connect 按钮，然后从左侧工具列表中选择所需工具并直接调用。

4️⃣ 修改源代码后重新测试

修改并保存 src/ 文件后，服务会自动重启。 在 Inspector 中点击 Reconnect 按钮，即可立即应用更改。

注意：需要 Node.js 18 或更高版本。

参与贡献

欢迎贡献！请提交 Pull Request。

1. Fork 此存储库
2. 创建功能分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 创建 Pull Request

许可证

ISC 许可证

支持

• 🐛 如果遇到问题，请在 GitHub Issues 中提交
• ⭐ 如果觉得有用，请点个星！

免责声明

本工具仅用于提供信息，并非投资建议。所有投资决策均由您自行承担责任。

---

English Version

🚀 Korea Stock MCP 正在迈出开源 MCP 之外的下一步。 基于可靠的韩国股票数据，我们正在筹备一项新服务，帮助 AI 提供值得信赖的答案。了解我们的计划。

用于韩国股票分析的 MCP 服务。
通过 DART（数据分析、检索和传输系统）与 KRX（韩国交易所）的官方 API，实现由 AI 驱动的股价和公示数据分析。

💬 欢迎提供反馈和功能建议！ 如果您对改进有任何想法，或在使用此工具时遇到问题，欢迎给我发邮件。 我会尽快查看并处理。 📧 [email protected]

🎯 主要功能

• 🔍 公示搜索 - 按公司和日期搜索公司公示
• 📊 公示数据 - 提供从原始公示报告解析的数据
• 💼 财务报表分析 - 基于 XBRL 的详细财务数据
• 📈 股票数据 - KRX（KOSPI/KOSDAQ）每日股价和股票基本信息

⚡ 快速开始

1️⃣ 注册 API KEY

您需要分别从 DART 和 KRX 获取 API KEY。

📝 注册 DART API KEY

1. 注册账号：在 OPEN DART 注册
2. 申请密钥：在认证密钥申请页面申请 API KEY
3. 查看密钥：在 Open API 使用状态确认已签发的 API KEY

📈 注册 KRX API KEY

1. 注册账号：在 KRX OPEN API 注册并登录

2. 申请密钥：转到「我的页面」→「API 认证密钥申请」，申请 API 认证密钥

3. 申请服务：获得批准后，转到「服务使用」→「股票」菜单

4. 申请 API 使用权限：针对以下 6 个项目分别点击「API 使用申请」

   • 证券每日交易信息
   • KOSDAQ 每日交易信息
   • KONEX 每日交易信息
   • 证券基本信息
   • KOSDAQ 基本信息
   • KONEX 基本信息

   ⏱️ 审批大约需要 1 天。

5. 验证密钥：获得批准后，在「我的页面」→「API 认证密钥签发记录」中查看 API KEY

2️⃣ 设置 Claude Desktop

1. 启动 Claude Desktop
2. 转到 Settings → Developer → Edit Configuration
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 分析韩国股票数据。

处理大型公示文件

一些公示报告（年报、季报等）是数 MB 大的 XML 文档。 一次性处理此类文档可能会超出 AI 响应限制或导致错误。

工作原理

系统会根据文档大小自动切换处理方式。

• 小型文档（小于 1MB）：立即返回完整文档。
• 大型文档（1MB 或以上）：返回目录（TOC），而非完整文档。Claude 会读取目录，并自动选择和获取与你的问题相关的章节。

用户指南

无需手动操作。 Claude 会自动处理大型文档。

文档较大时，Claude 会自动：

1. 查看文档目录。
2. 选择并获取与你的问题相关的章节。
3. 回答后列出其余章节，方便你请求任何感兴趣的其他章节。

示例：

• “展示年报中的营收概览” → Claude 会自动选择与营收相关的章节
• “再获取你刚才展示的目录中的第 3 节” → 你可以直接请求特定章节

💡 将复杂问题拆分为多个步骤

如果一次提问无法获得想要的答案，可以尝试将问题拆分为更小的步骤，以获得更准确的结果。

例如，与其问“展示 Inventera 证券登记声明中的外国投资者配股详情”，不如尝试：

1. “获取 Inventera 的 corp_code”
2. “搜索该公司的证券发行披露”
3. “获取该披露的文档内容”
4. “查找外国投资者配股表”

这样，你可以核验每个步骤的输出，并引导 Claude 找到你需要的确切信息。

---

可用工具

DART（数据分析、检索和传输系统）

1. get_disclosure_list - 披露搜索

   • 按类型、公司和日期搜索披露报告

2. get_corp_code - 公司代码查询

   • 提供在 DART 注册的披露公司的唯一代码、公司名称和股票代码
   • 按公司名称（corp_name）或股票代码（stock_code）搜索
   • 如果按名称搜索失败（例如，输入非韩文），会建议改用股票代码搜索

3. get_disclosure - 披露报告内容

   • 通过 DART API 解析原始披露报告文件
   • 对于大型文档，会返回 TOC；使用 section_id 获取特定章节

4. get_financial_statement - 财务报表

   • 上市公司和主要非上市公司的 XBRL 财务报表
   • 提供定期报告中的所有科目数据

KRX（韩国交易所）

1. get_stock_base_info - 股票基本信息

   • KOSPI、KOSDAQ 和 KONEX 上市股票的基本信息
   • 包含股票名称、代码和市场分类等基本数据

2. get_stock_trade_info - 每日交易信息

   • KOSPI、KOSDAQ 和 KONEX 股票的每日交易数据
   • 包含股价、交易量和市值等详细交易信息

3. get_market_type - 市场类型查询

   • 按股票代码查询市场分类（KOSPI/KOSDAQ/KONEX）
   • 提供查询股票数据所需的市场信息

其他工具

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

实际使用示例

📊 财务分析示例

提示词：“调查 Samyang Foods 在 2023 年 Q1-Q4、2024 年 Q1-Q4 和 2025 年 Q1-Q2 的销售额和营业利润，并查看增长率”
→ 查看 Samyang Foods 分析结果

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

🏢 企业分析示例

提示词：“告诉我 HJ SHIPBUILDING & CONSTRUCTION 如何盈利，并列出各业务部门的销售额” → 查看 HJ Shipbuilding & Construction 分析结果

📑 披露分析示例

提示词：“获取某 IPO 的外国配售详情（例如，Inventera / 0007J0）” → 查看 Inventera IPO 外国配售分析结果

API 数据源

• DART（Data Analysis, Retrieval and Transfer System）：上市公司披露信息和财务报表
• KRX（Korea Exchange）：股票基本信息和每日交易信息

本地开发与测试

修改源代码时如何进行测试。

1️⃣ 安装依赖

npm install

2️⃣ 设置环境变量

在项目根目录创建 .env 文件：

DART_API_KEY=your_dart_api_key
KRX_API_KEY=your_krx_api_key

3️⃣ 运行 MCP Inspector

npm run inspect

在浏览器中打开终端输出的 URL（例如 http://localhost:6274），即可打开 MCP Inspector 界面。

在 Inspector 中点击 Connect，然后从左侧面板选择任意工具并直接调用。

4️⃣ 修改源代码后重新测试

保存 src/ 下的文件时，服务会自动重启。 在 Inspector 中点击 Reconnect，即可立即应用更改。

注意：需要 Node.js 18 或更高版本。

贡献

欢迎贡献！请向我们提交 Pull Request。

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 创建 Pull Request

许可证

ISC 许可证

支持

• 🐛 如果遇到问题，请在 GitHub Issues 中提交
• ⭐ 如果觉得有用，请点亮星标！

免责声明

此工具仅供参考，不构成投资建议。所有投资决策均由您自行负责。