台股数据MCP服务器

🚀 TWStockMCPServer

一個全面的模型上下文協議 (MCP) 伺服器，專為台灣證券交易所 (TWSE) 數據分析設計，提供即時股票資訊、財務報表、ESG 數據和趨勢分析功能。

🌏 語言版本

• English | 繁體中文

🎬 示範影片

VSCode Copilot demo

Gemini CLI demo

觀看 TWStockMCPServer 功能展示

✨ 五大投資分析情境

📊 個股趨勢研判

短中長期技術面、基本面、籌碼面綜合分析

"分析台積電(2330)最近的走勢" / "鴻海(2317)適合長期投資嗎？"

💰 外資投資解讀

外資持股、產業流向、個股進出追蹤

"外資最近在買什麼股票？" / "半導體業外資投資趨勢如何？"

🔥 市場熱點捕捉

重大訊息、異常成交、權證活躍度監控

"今天有什麼重大消息？" / "哪些股票交易量異常活躍？"

💎 股利投資規劃

高殖利率篩選、除權息行事曆、配息穩定性分析

"推薦一些高殖利率股票" / "下個月有哪些公司要除權息？"

🎯 投資標的篩選

價值股/成長股篩選、ESG風險評估

"幫我找一些被低估的價值股" / "ESG表現好的公司有哪些？"

🧮 進階功能

期貨籌碼與選擇權分析

Put/Call Ratio、大額交易人未沖銷部位、三大法人期貨/選擇權部位

"台指期籌碼現在偏多還是偏空？" / "選擇權大額交易人在哪個價位布局？"

三大法人籌碼流向

上市/上櫃三大法人買賣超、外資產業配置

"三大法人今天買超哪些股票？" / "外資在哪個產業加碼？"

個股財報體檢

獲利能力、成長性、財務結構、配息政策、公司治理五面向分析

"幫我做台積電的財報體檢" / "這家公司的財務體質健不健康？"

買前風險掃描

處置股、注意股、當沖限制、停資停券名單比對

"這檔股票買進前有沒有被列處置或注意？"

期貨/三大法人歷史回溯查詢

openapi.taifex.com.tw 僅提供最新一個交易日，本專案改用期交所網站下載頁面 （www.taifex.com.tw）：預設查最新交易日，也可回溯查詢期貨/選擇權每日行情、三大法人部位、大額交易人部位； 股票代號可直接查對應的股票期貨；最近 30 個交易日的期貨盤中走勢（由每筆成交彙總成分鐘 K 線，含夜盤）

"幫我拉台指期最近一個月的每日OHLC" / "外資期貨部位過去三個月怎麼變化？" / "上週五台指期盤中是怎麼走的？"

財報／營收／股利多期歷史

財報、月營收、股利改由公開資訊觀測站（MOPS）提供（上市、上櫃、興櫃、公發公司皆可）：預設最新一期， 也可查任意過去季度的綜合損益表、資產負債表、現金流量表，多個月份的月營收，多年度股利分派，以及法說會行事曆； 另有重大訊息全文、董監持股與設質、內部人每月持股異動、庫藏股買回、背書保證與資金貸與

"比較台積電過去四季的毛利率和自由現金流" / "鴻海近五年配息穩定嗎？" / "這個月有哪些公司開法說會？" / "最近有哪些公司在買庫藏股？"

籌碼集中度與上櫃歷史

集保戶股權分散表（千張大戶、散戶持股比例，可看最近 13 週的逐週趨勢），上櫃個股日K、三大法人、融資融券可回溯任意過去日期； 上市當沖統計、除權息結果、類股指數歷史

"環球晶的大戶持股比例是多少？" / "半導體類指數上個月表現如何？"

ETF

所有投信、上市與上櫃（含債券 ETF、主動式 ETF）：基本資料（經理公司、追蹤指數、配息頻率、經理人、上櫃 ETF 管理費）、每日已發行單位數增減與預估淨值／折溢價排行、每月規模／受益人數／申購買回／定期定額趨勢（2007 年起），以及成分股：每月前十大持股（2021-08 起）與每季占淨值 1% 以上的持股（2021-09 起）

"0050 現在溢價多少？" / "哪些 ETF 今天被大量買回？" / "00981A 這半年受益人數怎麼變化？" / "00878 前十大持股是哪些？"

總體經濟

國發會景氣對策信號（景氣燈號）與領先/同時/落後指標、臺灣 PMI/NMI、中央銀行每日匯率

"現在景氣燈號是什麼顏色？" / "新台幣最近一個月升還是貶？"

⚙️ 快速開始

🚀 線上使用（由 Prefect Horizon 提供支援）

本專案由 Prefect Horizon 提供支援，免費託管線上 remote MCP Server：

{
  "twstockmcpserver": {
    "transport": "streamable_http",
    "url": "https://TW-Stock-MCP-Server.fastmcp.app/mcp"
  }
}

⚠️ 使用限制：為維持服務永續，此線上服務設有合理使用量上限（非無限制）。若需商業使用或較高呼叫量，強烈建議改用下方 Docker／本機方式自行架設伺服器，或使用 Prefect Horizon 的付費方案。

🙏 感謝 Prefect Horizon 支援本開源專案，讓社群能免費輕鬆試用。

🐳 Docker 使用（stdio）

{
  "twstockmcpserver": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "--pull=always",
      "-e",
      "MCP_STDIO=1",
      "ghcr.io/twjackysu/twsemcpserver:latest"
    ]
  }
}

🎛️ 只開部分資料來源

工具很多，用不到的來源可以關掉，減少 client 要讀的工具清單。來源代號：twse（證交所）、tpex（櫃買中心）、taifex（期交所）、mops（公開資訊觀測站）、tdcc（集保）、sitca（投信投顧公會）、ndc（國發會）、cbc（央行）。

• TWSE_INCLUDE_SOURCES=twse,tpex：只開這些來源（不設＝全部）
• TWSE_EXCLUDE_SOURCES=taifex：關掉這些來源

工具只要用到一個沒開的來源就不會出現（例如 ETF 基本資料同時查投信投顧公會、證交所、櫃買中心）。Docker 用 -e TWSE_EXCLUDE_SOURCES=taifex 傳入。

🔧 本地安裝

git clone https://github.com/twjackysu/TWStockMCPServer.git
cd TWStockMCPServer
uv sync && uv run fastmcp dev inspector server.py

📡 資料來源

🤝 參與貢獻

歡迎PR！

📄 授權 & 免責聲明

MIT授權 | 僅供參考，不構成投資建議