Korea Stock MCP

🚀 韓國股票MCP服務器

這是一個用於韓國股票分析的MCP服務器。藉助DART（電子公示系統）和KRX（韓國交易所）的官方API，能夠基於股價信息和公示資料開展AI分析。

🚀 快速開始

1️⃣ API密鑰申請

首先，你需要獲取DART和KRX的API密鑰。

📝 DART API密鑰申請

1. 註冊賬號：在 OPEN DART 完成註冊。
2. 申請密鑰：前往 認證密鑰申請頁面 申請API密鑰。
3. 查看密鑰：在 開放API使用情況 頁面查看已發放的API密鑰。

📈 KRX API密鑰申請

1. 註冊登錄：在 KRX開放API 進行註冊並登錄。

2. 申請密鑰：在“我的頁面”→“API認證密鑰申請”處提交申請。

3. 申請服務：審批通過後，進入“服務使用”→“股票”菜單。

4. 申請API使用：分別點擊以下6個項目的“API使用申請”：

   • 有價證券每日交易信息
   • 科斯達克每日交易信息
   • 科涅克斯每日交易信息
   • 有價證券基本信息
   • 科斯達克基本信息
   • 科涅克斯基本信息

   ⏱️ 審批大約需要1天時間。

5. 查看密鑰：審批通過後，在“我的頁面”→“API認證密鑰發放記錄”中查看API密鑰。

2️⃣ Claude Desktop配置

1. 啟動 Claude Desktop。
2. 依次點擊 設置 → 開發者 → 編輯配置。
3. 在 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>"
      }
    }
  }
}

4. 重啟：重啟Claude Desktop使配置生效。

現在，你可以使用Claude開始分析韓國股票數據了。

✨ 主要特性

• 🔍 公示搜索 - 支持按公司和時間段搜索公示信息。
• 📊 公示數據 - 提供對公示報告原始文件解析後的數據。
• 💼 財務報表分析 - 基於XBRL的詳細財務數據。
• 📈 股票數據 - 提供KRX（科斯皮/科斯達克）的每日股價信息和股票基本信息。

💻 使用示例

📊 財務分析示例

提示：“調查三養食品2023年、2024年1 - 4季度以及2025年1、2季度的銷售額、營業利潤，並計算增長率”
→ 查看三養食品分析結果

提示：“調查APR從2023年1季度到2025年2季度的銷售額、營業利潤增長情況，以及股價和市值走勢”
→ 查看APR分析結果

🏢 企業分析示例

提示：“告訴我HJ重工是如何盈利的，並提供各業務部門的銷售額”
→ 查看HJ重工分析結果

📚 詳細文檔

可用工具

DART（電子公示系統）

1. get_disclosure_list - 公示搜索
   • 可按類型、公司和日期搜索公示報告。
2. get_corp_code - 企業代碼查詢
   • 提供DART註冊公示公司的唯一代碼、公司名稱和股票代碼。
3. get_disclosure - 公示報告內容
   • 通過DART API解析公示報告原始文件。
4. get_financial_statement - 財務報表
   • 提供上市公司和主要非上市公司的XBRL財務報表。
   • 提供定期報告中的所有賬戶數據。

KRX（韓國交易所）

1. get_stock_base_info - 股票基本信息
   • 提供科斯皮、科斯達克和科涅克斯上市公司的基本信息。
   • 包括股票名稱、代碼和市場分類等基本數據。
2. get_stock_trade_info - 每日交易信息
   • 提供科斯皮、科斯達克和科涅克斯股票的每日交易數據。
   • 包括股價、交易量和市值等詳細交易信息。
3. get_market_type - 市場類型查詢
   • 根據股票代碼查詢市場分類（科斯皮/科斯達克/科涅克斯）。
   • 為股票數據查詢提供所需的市場信息。

其他工具

1. get_today_date - 今日日期查詢
   • 以YYYYMMDD格式提供當前日期。
   • 為AI準確查詢日期提供工具。

API數據源

• DART（電子公示系統）：上市公司公示信息和財務報表。
• KRX（韓國交易所）：股票基本信息和每日交易信息。

🔧 技術細節

貢獻方式

歡迎你為項目做出貢獻！請提交拉取請求。

1. 分叉此倉庫。
2. 創建功能分支（git checkout -b feature/AmazingFeature）。
3. 提交更改（git commit -m 'Add some AmazingFeature'）。
4. 推送到分支（git push origin feature/AmazingFeature）。
5. 打開拉取請求。

免責聲明

本工具僅用於信息提供，並非投資建議。所有投資決策由你自行負責。

📄 許可證

ISC許可證

支持

• 🐛 如果你遇到問題，請在GitHub問題中進行登記。
• ⭐ 如果你覺得本工具實用，請給它點個贊！