Korea Stock MCP

社区

基于官方 DART 和 KRX API 的韩国股票分析 MCP 服务器。

分类: 其他
Stars: ★ 177 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 需要 API Key / 凭据
许可证: ISC
最近提交: 2 个月前
工具数: 8

54FMRS · D

该 MCP 服务器提供了对韩国股票数据和披露文档的官方 API 访问，非常适合需要可靠信息的韩股投资者。它最大的优势是使用了 DART 和 KRX 的官方数据源，并提供了多种工具来支持全面的分析。用户需要注意密钥管理以及大型文档的处理方式。

最强项 · 安装易用性 13/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

10/20

文档质量

13/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: 仅提供 README 与 server manifest，无源码、CI 或测试可执行核验。manifest 的 stdio 传输、必需密钥变量与 README 中工具列表一致，快乐路径看似合理，但初始化握手、工具真实行为、错误处理和依赖可控性均无证据，因此扣分。
安全与权限 10/20: API 密钥以必需环境变量提供，manifest 标记为 secret，配置示例仅使用占位符，未发现真实令牌、恶意外传、破坏性操作等红线；数据流向 DART/KRX 官方 API 也有披露。扣分原因：未提供源码级审计，无法确认日志脱敏、网络最小化、权限边界与危险操作确认机制。
维护活跃度 10/20: 仓库未归档，带有 ISC 许可证，manifest 状态为 active 且版本为 1.1.5。没有提交/发布日期、依赖更新记录、issue 响应证据或安全通告渠道，只能依据这些有限元数据给到活跃但治理不完整的分值。
文档质量 13/20: README 为双语，覆盖安装、密钥申请、Claude Desktop 配置、工具说明、本地开发、示例和免责声明，并说明大文档分节处理。缺少完整参数模式、速率限制、费用和故障排查章节，且没有可复查的源代码证据支撑，故未给更高分。
安装易用性 13/20: 安装路径清晰：申请 DART/KRX 密钥、写入 Claude Desktop 配置、npx 启动，另有 npm 本地开发与 Inspector 测试说明，Node.js 版本已注明。但按静态校准，没有真实 CI 与测试文件证明可执行，且外部密钥审批流程较繁琐，评分不超过 15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要访问官方披露数据和财务报告的韩国股票投资者
专注于韩国市场的金融分析师
希望利用 AI 简化韩国股票研究的开发者

不适合谁

寻找全球股票市场覆盖的用户
需要实时市场数据或高频交易的用户
需要投资建议而非信息服务的人

所需权限

需要 DART_API_KEY 和 KRX_API_KEY 环境变量
通过 stdio 与 AI 客户端（如 Claude Desktop）交互

风险与副作用

根据免责声明，该工具仅供信息参考，不构成投资建议；用户自行承担投资决策风险。
API 密钥是秘密信息，应妥善管理，避免泄露。
大型披露文档处理可能导致响应时间过长或失败。

安装接入

准备工作

运行环境：Node.js 18+

DART_API_KEY 必填密钥 DART(전자공시시스템) 공시·재무제표 조회용 API 키로, opendart.fss.or.kr에서 회원가입 후 신청해 발급받습니다.

KRX_API_KEY 必填密钥 KRX OPEN API 키로, openapi.krx.co.kr에서 신청 후 승인(약 1일)되면 마이페이지에서 확인하며, 주식 관련 6개 서비스에 각각 이용신청이 필요합니다.

从 OPEN DART 和 KRX OPEN API 网站获取 DART 和 KRX API 密钥。
在 Claude Desktop 中，转到设置→开发者→编辑配置，并将配置 JSON 添加到 claude_desktop_config.json 中。
重启 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 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "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>"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add korea-stock-mcp -e 'DART_API_KEY=<YOUR_DART_API_KEY>' -e 'KRX_API_KEY=<YOUR_KRX_API_KEY>' -- npx -y korea-stock-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

Claude Desktop을 재시작한 후 툴 목록에 get_disclosure_list와 get_stock_trade_info가 나타나는지 확인하고, "오늘 날짜 알려줘"라고 물어 get_today_date가 응답하면 연결이 정상입니다.

常见排障

如果连接失败或未加载，请确保已正确设置环境变量。
如果 DART 或 KRX API 返回错误，请检查您是否已在相应服务上申请了所需的服务。
如果文档处理失败，请尝试将问题分解为小步骤。
如果使用 Claude Desktop，请确保已重启。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

삼양식품의 2024년 매출과 영업이익을 분기별로 알려줘
HJ중공업이 어떤 사업을 하고 있으며 사업부문별 매출은 얼마인지 알려줘
에이피알의 2023년부터 2025년까지 주가와 시가총액 흐름을 조사해줘
0007J0 종목의 IPO 외국인 배정 내역을 찾아줘

工具能力 8

get_disclosure_list 只读

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

get_corp_code 只读

查询 DART 注册披露公司的唯一代码、公司名称和股票代码。

get_disclosure 只读

通过 DART API 解析披露报告原始文件；对于大型文档，返回目录以供按需获取。

get_financial_statement 只读

获取上市和主要非上市公司的 XBRL 财务报表，包含定期报告中的所有账户数据。

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 准确获取日期。

使用场景

分析韩国上市公司的财务数据，如收入、营业利润和增长率。

搜索和解析公司披露报告，以获取特定信息，如 IPO 的外资分配。

查询韩国股票的每日价格、交易量和市值，以跟踪市场趋势。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

korea-stock-mcp 是一个用于韩国股票分析的 MCP 服务器，利用 DART（电子披露系统）和 KRX（韩国交易所）的官方 API，提供股价信息、披露数据、XBRL 财务报表以及每日交易数据。通过该服务器，AI 模型可以获取可靠的韩国股市数据，并进行分析和查询。