TWSEMCPServer

台灣證交所OpenAPI 的 MCP Server 同時整合部分即時報價和櫃檯買賣中心TPEx OpenAPI, 臺灣期貨交易所TAIFEX OpenAPI

LLM Mart 7 views 44 listing impressions

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

🌏 語言版本

🎬 示範影片

VSCode Copilot demo

VSCode Copilot demo

Gemini CLI 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

📡 資料來源

From the project's README.

Related servers

Read and write RAGE Package Format archives

23 views

See how ChatGPT, Claude, Gemini and Perplexity read any website. Scored out of 100.

19 views

MCP server for Geargrafx PC Engine / TurboGrafx-16 emulator

19 views

Read-only on-chain intel for AI agents on Base: balances, tokens, gas, tx status. No API keys.

15 views