korea-stock-insight-mcp

韩国股票洞察 MCP

mcp-name: io.github.yjhann33-design/korea-stock-insight-mcp

以英语为先的 MCP——专为全球大模型分析师打造，而非面向精通韩语的人士。

可直接用于 Claude Desktop、Cursor、Cline，以及任何 兼容 MCP 的客户端。用英语提问，通过一次工具调用链获取韩国公告、财务数据和 KOSPI/KOSDAQ 价格——包括 DART corp_code 查询、披露信息、XBRL 报表和每日 OHLCV。

你将获得什么

工具	功能
get_today_date	KST/UTC 的今天日期（YYYYMMDD）——进行任何日期范围查询前调用
get_corp_code	将韩国公司名称或 6 位股票代码解析为 DART corp_code
get_disclosure_list	最近的 DART 文件（日期、标题、类型、接收编号）
get_disclosure	文件元数据和规范查看器 URL
get_financial_statement	完整的 XBRL 财务报表（合并/单独、季度/年度）
get_stock_quote	KOSPI/KOSDAQ 每日 OHLCV 数据（通过 yfinance，无需密钥）

DART（전자공시시스템）是韩国的电子披露系统，相当于美国证券交易委员会运营的 SEC EDGAR，由金融监督院（FSS）负责运营。

为什么以英语为先很重要

韩国上市公司的公开文件以韩语撰写，股票代码是没有全球通用记忆方式的 6 位数字，披露系统 DART 也没有与 EDGAR 全文搜索相当的英文功能。对于非韩语分析师而言，正式开展研究前就要跨越这三重障碍。

本服务将它们一并消除。工具描述、参数名称和示例都是为不懂韩语的大模型编写的——公司查询支持英文名称（“Samsung Electronics”“Naver”），响应会在适当之处提供英文背景信息，整个工作流只需一次 Claude/Cursor 对话，而不是打开三个浏览器标签页。

• 以英语为先的工具描述——名称、参数和示例全都使用英语
• 一站式提供 DART + KRX——通过单个 MCP 获取披露信息、财务数据和每日价格
• 一行安装，无需账户——运行 uvx korea-stock-insight-mcp 即可（只需免费的 DART 密钥）
• 本地 stdio、MIT、无遥测——你的查询不会离开本机

快速开始（Claude Desktop）

1. 获取免费的 DART API 密钥

在 opendart.fss.or.kr 注册，并从用户页面获取 API 密钥。即时免费，无需信用卡。

2. 添加到 Claude Desktop 配置

编辑 claude_desktop_config.json（位置：macOS ~/Library/Application Support/Claude/，Windows %APPDATA%\Claude\）：

{
  "mcpServers": {
    "korea-stock-insight": {
      "command": "uvx",
      "args": ["korea-stock-insight-mcp"],
      "env": {
        "DART_API_KEY": "YOUR_DART_KEY_HERE"
      }
    }
  }
}

如果你没有 uvx，请先安装 uv（macOS/Linux/Windows 均可一行安装），或使用 pipx：

{
  "mcpServers": {
    "korea-stock-insight": {
      "command": "pipx",
      "args": ["run", "korea-stock-insight-mcp"],
      "env": {"DART_API_KEY": "YOUR_DART_KEY_HERE"}
    }
  }
}

3. 重启 Claude Desktop 并试用

“Samsung Electronics 最近有哪些披露？请调取其上一季度的收入和营业利润。”

Claude 会自动依次调用 get_corp_code("Samsung Electronics") → get_disclosure_list("005930") → get_financial_statement(corp_code, 2025, "FY")。

示例查询（30 秒，复制粘贴到 Claude）

全球分析师实际用于韩国股票的三种工作流。每种工作流都会自动串联 2–4 次工具调用。

1. 存储器周期同行比较

“比较 Samsung Electronics 和 SK Hynix 最近年度文件中的收入、营业利润率和资本支出，并指出两者的差异。”

将两个名称解析为 corp_codes → 获取最新 XBRL → 并列返回结果。适用于追踪 HBM/DRAM 周期。

2. 催化剂出现前的披露雷达

“列出 Naver 过去 30 天的 DART 文件。标记与财报、并购、股票回购或高管变动有关的内容。”

使用 get_disclosure_list 并指定日期范围，然后由 Claude 对标题进行分类。无需阅读韩文——工具说明会告诉 Claude 要查找哪些文件类型。

3. 一次获取股价与文件背景

“Kakao 最近提交了什么文件？过去 90 天里，它在 KOSPI 上的股价走势如何？”

结合 get_disclosure_list 和 get_stock_quote，即可在同一条回复中获取新闻和价格反应。

其他示例

• “调取 LG Energy Solution 最近的年度报告，并总结管理层讨论。”
• “KODEX 200 ETF 过去 6 个月的走势如何？”（ETF 也适用）
• “列出 Hyundai Motor 在 2025 年所有标记为重大决定（주요사항보고서）的披露。”

路线图

• v0.2 — 提取完整披露正文（压缩的 XBRL → 纯文本）
• v0.3 — 多公司批量查询、行业汇总
• 未来 — 可选的托管服务层，提供英文摘要披露和 webhook 推送（暂无预计时间；请在 GitHub Issues 中跟踪进展）

反馈与贡献

这是我独自维护的项目，而且 stdio 模式意味着我看不到有哪些人在使用它。我唯一能获取的信号是 PyPI 下载量、GitHub 星标，以及你告诉我的信息。

如果这对你有帮助，请告诉我：

• 🐛 提交问题 — Bug、缺少的工具、失效的查询
• 💬 参与讨论 — “有人分析过 [ticker] 吗？”、“这是适用于 X 的工具吗？”，以及一般问题
• ⭐ 为仓库点星 — 最简单的需求反馈方式，也有助于规划路线图

如果你确实在使用 Claude/Cursor 分析韩国股票，我很想了解你会运行哪些查询，以及还缺少什么。

许可证

MIT。请参阅 LICENSE。

致谢

• 韩国金融监督院提供的 DART OpenAPI
• 通过 yfinance 获取的 KRX 每日价格
• Anthropic 提供的 Model Context Protocol