Korea Stock MCP 是一个面向韩国股票分析的 MCP 服务器，供 AI 客户端调用。其目标是通过 DART（电子公示系统）与 KRX（韩国交易所）的官方 API，实现基于股价信息与公示资料的 AI 分析。项目在 README 中表示，正在筹备基于准确韩国股票数据、帮助 AI 给出更可信回答的新服务，但新服务的具体内容与收费方式暂未提供。
用途方面，该服务器主要服务于韩国上市公司相关数据的检索与分析，包括公示搜索、公示数据获取、财务报表分析以及股票行情查询。
主要能力由以下工具组成： get_disclosure_list 用于按公示类型、公司、日期搜索公示报告； get_corp_code 用于查询 DART 登记公示对象公司的唯一编号、公司名与股票代码，可用公司名或股票代码查询，公司名搜索失败时会提示改用股票代码重试； get_disclosure 用于通过 DART API 解析公示报告原始文件，大容量文档返回目录，并可用 section_id 查询特定章节； 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 准确获取日期。
使用方式上，需先申请 API KEY。DART 侧需在 OPEN DART 注册、在认证密钥申请页面申请 API KEY，并在开放 API 使用现状中确认签发的密钥。KRX 侧需在 KRX OPEN API 注册登录，在「我的页面 → API 认证密钥申请」中申请，批准后进入「服务利用 → 股票」菜单，对以下 6 个项目分别点击「API 利用申请」：有价证券日度买卖信息、科斯达克日度买卖信息、科内克斯日度买卖信息、有价证券个股基本信息、科斯达克个股基本信息、科内克斯个股基本信息，批准约需 1 天，批准后在「我的页面 → API 认证密钥签发明细」中确认密钥。随后在 Claude Desktop 中进行配置：打开 Claude Desktop，进入「设置 → 开发者 → 编辑配置」，在 claude_desktop_config.json 文件中添加配置内容并重启 Claude Desktop 生效。本地开发测试时，需安装依赖、在项目根目录创建 .env 文件设置环境变量，运行 MCP Inspector 后在浏览器打开终端输出的地址（如 http://localhost:6274），在 Inspector 中点击 Connect，再从左侧工具列表选择工具直接调用；修改 src/ 下文件保存后服务器会自动重启，在 Inspector 中点击 Reconnect 即可立即反映变更。需注意 Node.js 18 以上版本。
大容量公示报告处理机制方面，部分公示报告（如事业报告、季度报告等）是数 MB 的大型 XML 文档，一次性处理可能超出 AI 响应限制或引发错误。该工具根据文档大小自动切换处理方式：小于 1MB 的文档直接返回全文；1MB 及以上的文档返回目录（TOC），由 Claude 查看目录后自动选择与问题相关的章节并获取内容，无需手动操作。回答后还会列出剩余章节列表，用户可继续请求其他章节。用户也可在目录中直接指定某章节（如「查询第 3 节」）。对于复杂问题，建议拆分为多个步骤提问，例如先获取 corp_code，再搜索证券发行相关公示列表，再获取该公示正文，最后查找外国投资者配售明细。
适用场景包括：财务分析（如查询某公司多年各季度销售额、营业利润及增长率）、企业分析（如了解某公司靠什么赚钱及各部门销售额）、公示分析（如查询某 IPO 的外国投资者配售明细）等。
限制方面，项目明确该工具仅用于信息提供目的，不构成投资建议，所有投资决策由本人负责。API KEY 需用户自行申请，KRX 部分接口需逐项申请且约需 1 天审批。新服务的具体内容、收费与价格等信息暂未提供。项目欢迎通过 Pull Request 贡献，问题可登记到 GitHub Issues。
