🚀 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授權 | 僅供參考，不構成投資建議
