Pykrx MCP

🚀 pykrx-mcp

pykrx-mcp是一個基於MCP（Model Context Protocol）的服務器，它能為AI智能體提供韓國股票市場數據。藉助 pykrx 庫，用戶可以通過ChatGPT和Claude等工具，以自然語言的方式查詢KOSPI、KOSDAQ、KONEX市場的股票價格、財務報表、投資者供需、賣空等各類數據。

🚀 快速開始

Claude Desktop中使用

自動安裝（推薦）

通過MCP Registry一鍵安裝：

npx @modelcontextprotocol/inspector install pykrx-mcp

手動安裝

手動修改Claude Desktop的配置文件：

• macOS/Linux：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pykrx": {
      "command": "uvx",
      "args": ["pykrx-mcp"]
    }
  }
}

配置完成後，重啟Claude Desktop即可使用。

✨ 主要特性

自然語言對話式界面

無需複雜的API語法，使用日常語言就能查詢數據。

即時韓國股票市場數據

提供KRX（韓國證券交易所）的最新數據。

多樣化分析功能

• 價格趨勢分析
• 投資者供需分析
• 財務指標比較
• 賣空情況分析

AI智能體優化

支持MCP協議，可直接在ChatGPT和Claude中使用。

📦 安裝指南

本地開發環境配置

具體內容請參考 DEVELOPMENT.md。

# 克隆倉庫
git clone https://github.com/sharebook-kr/pykrx-mcp.git
cd pykrx-mcp

# 安裝依賴
uv pip install -e ".[dev]"

# 運行測試
uv run pytest

# 啟動服務器
uv run pykrx-mcp

💻 使用示例

股價查詢

個別股票股價

"顯示三星電子最近一個月的股價"
"獲取SK海力士2024年1月的OHLCV數據"
"分析 Kakao 上週的股價走勢"

市場整體行情

"顯示今日KOSPI所有股票的行情"
"KOSDAQ前10名股票的價格變動率"

市值與交易量

"三星電子的市值是多少？"
"三星電子最近一個月的交易量趨勢"
"分析 Naver 的交易金額"

財務指標

"告訴我三星電子的PER和PBR"
"三星電子的股息收益率是多少？"
"Naver 最近的 EPS 是多少？"

投資者供需分析

"三星電子的外國投資者買入情況如何？"
"分析 Kakao 最近的機構供需情況"
"KOSPI 中個人投資者大量買入的股票"
"外國投資者淨買入的前10名股票"

賣空分析

"三星電子的賣空比例是多少？"
"告訴我KOSPI賣空排名靠前的股票"
"賣空餘額最高的股票是哪隻？"

指數查詢

"KOSPI指數最近一個月的走勢"
"KOSDAQ 150指數的PER是多少？"
"告訴我半導體板塊指數的成分股"

外國投資

"三星電子的外國投資者持股比例是多少？"
"外國投資者限額耗盡率高的股票"

股票搜索

"KOSPI股票列表"
"005930 是什麼股票？"
"今天交易的ETF列表"

📚 詳細文檔

支持的數據和API

所有API均基於 pykrx庫 實現。

股票數據（Stock Data）

• 股票信息
  • get_market_ticker_list：按市場查詢股票代碼
  • get_market_ticker_name：通過股票代碼查詢股票名稱
• 價格數據
  • get_stock_ohlcv：單個股票的OHLCV（開盤價/最高價/最低價/收盤價/交易量）
  • get_market_ohlcv_by_date：特定日期所有股票的行情
  • get_market_price_change：所有股票的期間價格變動
• 市值
  • get_market_cap_by_date：查詢單個股票的市值
• 財務指標
  • get_market_fundamental_by_date：PER、PBR、EPS、DIV、BPS、DPS
• 投資者交易
  • get_market_trading_value_by_date：按股票的投資者供需（交易金額）
  • get_market_trading_volume_by_investor：按投資者的交易量
  • get_market_trading_value_by_investor：按投資者的交易金額
  • get_market_net_purchases_of_equities：投資者淨買入排名靠前的股票

指數數據（Index Data）

• 指數信息
  • get_index_ticker_list：指數代碼列表
  • get_index_ticker_name：查詢指數名稱
  • get_index_portfolio_deposit_file：指數成分股
• 指數價格
  • get_index_ohlcv：指數OHLCV數據
• 指數指標
  • get_index_fundamental：指數PER/PBR/股息收益率

賣空數據（Short Selling）

• get_shorting_status_by_date：按股票的賣空情況
• get_shorting_volume_by_ticker：所有股票的賣空交易量
• get_shorting_balance_top50：賣空餘額前50名
• get_shorting_volume_top50：賣空交易比例前50名

外國投資（Foreign Investment）

• get_exhaustion_rates_of_foreign_investment：外國投資者持股量及限額耗盡率

ETF數據

• get_etf_ticker_list：ETF股票列表
• get_etf_ohlcv_by_date：ETF的OHLCV數據

共支持23種數據查詢工具

🔧 技術細節

• Python 3.10+
• pykrx：韓國股票市場數據收集
• FastMCP：MCP服務器框架
• MCP (Model Context Protocol)：與AI智能體的通信協議

📄 許可證

本項目採用MIT許可證，你可以自由使用！

🌟 相關項目

• pykrx：韓國股票市場數據收集庫（本項目的基礎）
• MCP：Model Context Protocol官方文檔

☕ 支持我們

如果本項目對你有幫助，請支持開發者！

👥 貢獻

歡迎提交問題和拉取請求！