微信扫一扫article
README
🚀 韩国股票MCP服务器
这是一个用于韩国股票分析的MCP服务器。借助DART（电子公示系统）和KRX（韩国交易所）的官方API，能够基于股价信息和公示资料开展AI分析。
🚀 快速开始
1️⃣ API密钥申请
首先，你需要获取DART和KRX的API密钥。
📝 DART API密钥申请
📈 KRX API密钥申请
-
注册登录：在 KRX开放API 进行注册并登录。
-
申请密钥：在“我的页面”→“API认证密钥申请”处提交申请。
-
申请服务：审批通过后，进入“服务使用”→“股票”菜单。
-
申请API使用：分别点击以下6个项目的“API使用申请”：
- 有价证券每日交易信息
- 科斯达克每日交易信息
- 科涅克斯每日交易信息
- 有价证券基本信息
- 科斯达克基本信息
- 科涅克斯基本信息
⏱️ 审批大约需要1天时间。
-
查看密钥：审批通过后，在“我的页面”→“API认证密钥发放记录”中查看API密钥。
2️⃣ Claude Desktop配置
- 启动 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使配置生效。
现在，你可以使用Claude开始分析韩国股票数据了。
✨ 主要特性
- 🔍 公示搜索 - 支持按公司和时间段搜索公示信息。
- 📊 公示数据 - 提供对公示报告原始文件解析后的数据。
- 💼 财务报表分析 - 基于XBRL的详细财务数据。
- 📈 股票数据 - 提供KRX（科斯皮/科斯达克）的每日股价信息和股票基本信息。
💻 使用示例
📊 财务分析示例
提示：“调查三养食品2023年、2024年1 - 4季度以及2025年1、2季度的销售额、营业利润，并计算增长率”
→ 查看三养食品分析结果
提示：“调查APR从2023年1季度到2025年2季度的销售额、营业利润增长情况，以及股价和市值走势”
→ 查看APR分析结果
🏢 企业分析示例
提示：“告诉我HJ重工是如何盈利的，并提供各业务部门的销售额”
→ 查看HJ重工分析结果
📚 详细文档
可用工具
DART（电子公示系统）
- get_disclosure_list - 公示搜索
- 可按类型、公司和日期搜索公示报告。
- get_corp_code - 企业代码查询
- 提供DART注册公示公司的唯一代码、公司名称和股票代码。
- get_disclosure - 公示报告内容
- 通过DART API解析公示报告原始文件。
- get_financial_statement - 财务报表
- 提供上市公司和主要非上市公司的XBRL财务报表。
- 提供定期报告中的所有账户数据。
KRX（韩国交易所）
- get_stock_base_info - 股票基本信息
- 提供科斯皮、科斯达克和科涅克斯上市公司的基本信息。
- 包括股票名称、代码和市场分类等基本数据。
- get_stock_trade_info - 每日交易信息
- 提供科斯皮、科斯达克和科涅克斯股票的每日交易数据。
- 包括股价、交易量和市值等详细交易信息。
- get_market_type - 市场类型查询
- 根据股票代码查询市场分类（科斯皮/科斯达克/科涅克斯）。
- 为股票数据查询提供所需的市场信息。
其他工具
- get_today_date - 今日日期查询
- 以YYYYMMDD格式提供当前日期。
- 为AI准确查询日期提供工具。
API数据源
- DART（电子公示系统）：上市公司公示信息和财务报表。
- KRX（韩国交易所）：股票基本信息和每日交易信息。
🔧 技术细节
贡献方式
欢迎你为项目做出贡献！请提交拉取请求。
- 分叉此仓库。
- 创建功能分支（
git checkout -b feature/AmazingFeature）。 - 提交更改（
git commit -m 'Add some AmazingFeature'）。 - 推送到分支（
git push origin feature/AmazingFeature）。 - 打开拉取请求。
免责声明
本工具仅用于信息提供，并非投资建议。所有投资决策由你自行负责。
📄 许可证
ISC许可证
支持
- 🐛 如果你遇到问题，请在GitHub问题中进行登记。
- ⭐ 如果你觉得本工具实用，请给它点个赞！