Korea Stock MCP

韩国股票MCP服务器

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

💬 欢迎您的改进请求和反馈！ 如果您在使用过程中有任何不便或改进的想法，请随意发送电子邮件。 我会尽快确认并反映的。 📧 wowlxx28@gmail.com

🎯 主要功能

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

-快速开始

1发放⃣API KEY

首先，您必须获得DART和KRX的API KEY。

📝 DART API KEY发放

1. 会员注册: 开放飞镖 会员注册
2. 密钥申请: 认证密钥申请页面在中申请API KEY
3. 确认密钥: 开放API使用情况验证由颁发的API KEY

📈 KRX API KEY发放

1. 会员注册: KRX OPEN API公司在中注册和登录会员

1. 密钥申请：在我的页面→API验证密钥申请中申请

1. 服务申请：批准后使用服务→转到股票菜单

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

- 有价证券每日买卖信息 - KOSDAQ每日交易信息 - KONEX每日销售信息 - 有价证券项目基本信息 - KOSDAQ股票基本信息 - KONEX项目基本信息

> ⏱️ 批准大约需要1天。

1. 确认密钥：批准后在我的页面→API验证密钥发放历史记录中查看API KEY

2⃣Claude桌面设置

1. 克劳德桌面版 执行
2. 设置 → 开发者 → 编辑配置 点击
3. claude_desktop_config.json 将以下内容添加到文件：

{
  "mcpServers": {
    "korea-stock-mcp": {
      "command": "npx",
      "args": ["-y", "korea-stock-mcp@latest"],
      "env": {
        "DART_API_KEY": "",
        "KRX_API_KEY": ""
      }
    }
  }
}

1. 重启：重新启动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. “帮我查外国人分配明细”

通过按步骤进行，您可以在查看每个步骤的结果的同时获得所需的信息。

______________________________________________________________________

可用工具

DART（电子公告系统）

1. get_disclosure_list -公示搜索

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

1. get_corp_code -查询唯一编号

- 提供DART注册公告目标公司的唯一编号、公司名称和项目代码 - 公司名称（corp_name）或项目代码（stock_code）之一可查询 - 公司名称搜索失败时，请使用项目代码重试

1. get_disclosure -公示报告原文

- 通过DART API解析公示报告源文件 - 对于大型文档，将返回目录。 section_id可通过查看特定部分

1. get_财务报表 -财务报表

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

KRX（韩国交易所）

1. get_stock_base_info -项目基本信息

- KOSPI、KOSDAQ、KONEX上市项目基本信息 - 项目名称、项目代码、市场划分等基本数据

1. get_stock_trade_info -每日交易信息

- KOSPI、KOSDAQ、KONEX各股票的每日交易数据 - 股价、交易量、市价总额等详细交易信息

1. get_market_type -查看市场划分

- 通过项目代码查询相关项目的市场划分（KOSPI/COSDAQ/CONEX） - 查询股票数据时提供所需的市场信息

其他工具

1. 获取日期 -查询今天的日期

- 以YYYYMMDD格式提供当前日期 - 用于AI准确日期查询的工具

实际使用示例

📊 财务分析示例

提示：“请调查三洋食品2023年、2024年第一季度、2025年第一季度、第二季度的销售额、营业利润，并调查增长率。”\ → 查看三养食品分析结果

提示：“请调查APAL 23年第一季度至25年第二季度的销售额、营业利润增长和股价、市值走势。”\ → 查看APAL分析结果

🏢 企业分析示例

提示：“告诉我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中 连接 单击按钮后，可以从左侧工具列表中选择所需的工具并直接调用。

修改4⃣源后重新测试

src/ 修改并保存文件后，服务器将自动重新启动。 在Inspector中 重新连接 单击按钮可立即反映更改。

参考：需要Node.js 18或更高版本。

贡献

欢迎您的贡献！请发送Pull Request。

1. 请把这个存储库叉起来
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
• 如果有用的话，请点击明星！

免责条款

本工具旨在提供信息，不是投资建议。所有投资决定都由本人负责。

______________________________________________________________________

英文版本

用于韩国股票分析的MCP服务器。\ 通过DART（数据分析、检索和传输系统）和KRX（韩国交易所）的官方API，对股票价格和披露数据进行人工智能分析。

💬 欢迎反馈和功能请求！ 如果您在使用此工具时有任何改进或问题的想法，请随时给我发电子邮件。 我会尽快审查并解决这些问题。 📧 wowlxx28@gmail.com

🎯 主要特点

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

⚡ 快速开始

1.️⃣ API密钥注册

您需要从DART和KRX获得API密钥。

📝 DART API密钥注册

1. 注册：注册地址 开放飞镖
2. 请求密钥：在申请API密钥 身份验证密钥应用页面
3. 检查：验证发布的API密钥 打开API使用状态

📈 KRX API密钥注册

1. 注册：注册并登录 KRX OPEN API公司

1. 请求密钥：在我的页面中申请API身份验证密钥→ API身份验证密钥应用程序

1. 服务应用程序：批准后，转到服务使用→ 库存菜单

1. API使用应用程序：点击“API使用应用程序”，选择以下6项中的每一项

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

> ⏱️ 审批大约需要1天。

1. 密钥验证：批准后，请在我的页面中检查API密钥→ API身份验证密钥发布历史记录

2.️⃣ Claude桌面设置

1. 发射 克劳德桌面版
2. 首选 设置 → 开发者 → 编辑配置
3. 将以下内容添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "korea-stock-mcp": {
      "command": "npx",
      "args": ["-y", "korea-stock-mcp@latest"],
      "env": {
        "DART_API_KEY": "",
        "KRX_API_KEY": ""
      }
    }
  }
}

1. 重启：重新启动Claude Desktop以应用设置

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

大型披露文件处理

一些披露报告（年度报告、季度报告等）是几MB的大型XML文档。 一次性处理此类文档可能会超过AI响应限制或导致错误。

它是如何工作的？

处理方法会根据文档大小自动更改。

• 小文件（1MB以下）：立即返回整个文档。
• 大型文档（1MB或以上）：返回a 目录（TOC） 而不是完整的文档。Claude阅读TOC，并自动选择和获取与您的问题相关的部分。

用户指南

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

当文档较大时，Claude会自动：

1. 检查文档的目录。
2. 选择并获取与您的问题相关的部分。
3. 回答后，列出剩余的部分——这样你就可以请求任何你感兴趣的其他部分。

示例：

• “显示年度报告中的收入概览”→ 克劳德汽车选择收入相关部分
• “还可以从刚才显示的目录中提取第3节”→ 您可以直接请求特定部分

💡 将复杂问题分解为步骤

如果你不能一下子得到你想要的答案，试着把你的问题分解成更小的步骤，以获得更准确的结果。

例如，不要“向我展示Inventera证券登记声明中的外国投资者配置详细信息”，而是尝试：

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

这样，您就可以验证每个步骤的输出，并引导Claude获得您需要的确切信息。

______________________________________________________________________

可用工具

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

1. get_disclosure_list -披露搜索

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

1. get_corp_code -公司代码查询

- 提供DART注册披露公司的唯一代码、公司名称和股票代码 - 按公司名称搜索(corp_name)或股票代码(stock_code) - 如果名称搜索失败（例如非韩语输入），建议使用股票代码重试

1. get_disclosure -披露报告内容

- 通过DART API分析原始披露报告文件 - 对于大型文档，返回TOC；使用 section_id 获取特定部分

1. get_财务报表 -财务报表

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

KRX（韩国交易所）

1. get_stock_base_info -股票基本信息

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

1. get_stock_trade_info -每日交易信息

- KOSPI、KOSDAQ和KONEX股票的每日交易数据 - 详细的交易信息，包括股票价格、交易量和市值

1. get_market_type -市场类型查询

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

其他工具

1. 获取日期 -今天的日期查询

- 以YYYYMMDD格式提供当前日期 - AI精确日期查询工具

实际使用示例

📊 财务分析示例

提示：“调查三阳食品2023年第一季度、2024年第一季度和2025年第一季度的销售和营业利润，并检查增长率”\ → 见三阳食品分析结果

提示：“调查2023年第一季度至2025年第二季度APR的销售额和营业利润增长，以及股价和市值趋势” → 见APR分析结果

🏢 企业分析示例

提示：“告诉我HJ造船与建设公司是如何赚钱的，包括按业务部门划分的销售额” → 见HJ造船与建造分析结果

📑 披露分析示例

提示：“获取IPO的外国分配详细信息（例如Inventera/0007J0）” → 见英威达IPO外资配置分析结果

API数据源

• 数据分析、检索和传输系统：上市公司披露信息和财务报表
• KRX（韩国交易所）：股票基本信息和日常交易信息

本地开发和测试

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

1.️⃣ 安装依赖项

npm install

2.️⃣ 设置环境变量

创建一个 .env 项目根目录中的文件：

DART_API_KEY=your_dart_api_key
KRX_API_KEY=your_krx_api_key

3.️⃣ 运行MCP检查器

npm run inspect

打开终端中打印的URL（例如。 http://localhost:6274)在浏览器中打开MCP检查器UI。

点击 连接 在检查器中，然后从左侧面板中选择任何工具直接调用它。

4.️⃣ 修改源后重新测试

当您在下保存文件时 src/，服务器会自动重新启动。 点击 重新连接 在检查员处立即领取更改。

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

贡献

欢迎投稿！请向我们发送拉取请求。

1. 分叉此存储库
2. 创建要素分支(git checkout -b feature/AmazingFeature)
3. 提交您的更改(git commit -m 'Add some AmazingFeature')
4. 推到分支(git push origin feature/AmazingFeature)
5. 打开拉取请求

许可证

ISC许可证

支持

• 🐛 如果您有问题，请在GitHub issues中注册
• ⭐ 如果你觉得它有用，请给它一颗星！

免责声明

此工具仅供参考，不是投资建议。所有的投资决策都是你自己的责任。