台灣股票即時分析 MCP 服務器
Taiwan Stock Real-Time Analysis MCP Server
一個功能強大的 MCP (Model Context Protocol) 服務器，專為台灣股票市場設計，提供即時報價、技術分析和智能買賣建議。
🌟 核心功能
1. 即時報價查詢
📊 單支股票即時報價
📈 多支股票批量查詢
💹 買賣五檔完整資訊
⏰ 即時更新（約每5秒）
2. 技術分析
📉 趨勢判斷（上漲/下跌/盤整）
📍 價格位置分析（高檔/中檔/低檔）
🎯 多層次分析（基本/進階/完整）
3. 智能建議
💡 買進/賣出/觀望建議
🎲 風險等級評估
📋 詳細理由說明
⚖️ 買賣價差分析
4. 比較分析
🔍 多股同時比較
📊 關鍵指標對比
🏆 相對強弱分析
🚀 快速開始
安裝依賴
運行服務器
配置 Claude Desktop
在 Claude Desktop 的配置文件中添加：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
🛠️ 可用工具
1. get_stock_realtime_quote
取得單支股票的即時報價資訊。
輸入參數:
stock_code(必填): 股票代碼，例如 "2330"response_format(可選): "markdown" 或 "json"，預設為 "markdown"
使用範例:
回應內容:
成交價格與漲跌幅
開盤/最高/最低/昨收
成交量
買賣五檔價量
更新時間
2. get_multiple_stocks_quotes
同時查詢多支股票的即時報價。
輸入參數:
stock_codes(必填): 股票代碼列表，最多20支response_format(可選): 輸出格式
使用範例:
適用場景:
投資組合監控
類股比較
同產業分析
3. analyze_stock_with_suggestion
進行技術分析並提供買賣建議。
輸入參數:
stock_code(必填): 股票代碼analysis_type(可選): "basic" / "advanced" / "full"，預設 "basic"response_format(可選): 輸出格式
使用範例:
分析內容:
即時報價資訊
趨勢判斷（上漲/下跌/平盤）
價格位置（高檔/中檔/低檔區）
建議動作（買進/賣出/觀望）
詳細理由與風險評估
4. compare_stocks
比較多支股票的表現和技術面。
輸入參數:
stock_codes(必填): 要比較的股票代碼列表response_format(可選): 輸出格式
使用範例:
比較項目:
當前價格
漲跌幅
趨勢方向
價格位置
交易建議
風險等級
📊 使用案例
案例 1: 快速查詢台積電報價
對話:
案例 2: 投資決策分析
對話:
案例 3: 類股比較
對話:
案例 4: 投資組合監控
對話:
🎯 智能建議邏輯
本 MCP 服務器採用多維度分析來生成交易建議：
分析維度
趨勢分析
比較當前價格與昨收價
判斷是上漲、下跌或平盤
評估趨勢強度
價格位置
計算當前價格在今日價格區間的位置
高檔區 (80%+): 接近最高價
中高檔區 (60-80%): 略高位置
中檔區 (40-60%): 中間位置
中低檔區 (20-40%): 略低位置
低檔區 (<20%): 接近最低價
買賣力道
分析買賣五檔的價量分布
計算買賣價差
評估市場流動性
決策矩陣
趨勢 | 價格位置 | 建議動作 | 風險等級 |
上漲 | 低檔 (<40%) | 買進 | 中等 |
上漲 | 中檔 (40-70%) | 觀望/小量買進 | 中高 |
上漲 | 高檔 (>70%) | 觀望 | 高 |
下跌 | 高檔 (>60%) | 賣出/減碼 | 中高 |
下跌 | 中檔 (30-60%) | 觀望 | 中等 |
下跌 | 低檔 (<30%) | 觀望/小量買進 | 中等 |
平盤 | 低檔 (<30%) | 可考慮買進 | 中低 |
平盤 | 中檔 (30-70%) | 觀望 | 中等 |
平盤 | 高檔 (>70%) | 觀望 | 中等 |
📡 資料來源
台灣證券交易所 (TWSE): 上市股票資料
櫃買中心 (TPEx): 上櫃股票資料
更新頻率: 約每5秒更新一次
API 限制: 每5秒最多3個請求
⚠️ 重要聲明
免責條款
非投資建議: 本工具提供的所有分析和建議僅供參考，不構成任何投資建議或建議。
自行評估: 投資前請務必進行完整的基本面和技術面評估，並考慮個人的風險承受能力。
市場風險: 股票投資具有市場風險，過去的表現不代表未來的結果，投資人應審慎評估。
資料延遲: 雖然資料來源為官方交易所，但仍可能存在延遲，請以券商報價為準。
系統限制: 技術分析基於有限的即時數據，無法完全反映市場所有資訊。
使用限制
請勿過度頻繁查詢，遵守交易所 API 使用規範
僅供個人使用，不得用於商業用途
不保證資料的完整性和準確性
🔧 技術架構
核心技術
MCP SDK: FastMCP 框架
HTTP 客戶端: httpx (異步請求)
資料驗證: Pydantic v2
輸出格式: Markdown / JSON
設計特點
異步處理: 所有 API 請求使用 async/await
錯誤處理: 完整的異常捕獲和友善錯誤訊息
資料驗證: Pydantic 模型自動驗證輸入
格式彈性: 支援 Markdown 和 JSON 兩種輸出
速率控制: 自動控制請求頻率避免被封鎖
🤝 貢獻
歡迎提交 Issue 和 Pull Request！
📄 授權
MIT License
📮 聯繫方式
有任何問題或建議，歡迎聯繫！
⭐ 如果這個專案對你有幫助，請給個星星！
最後更新: 2025-10-17 版本: 1.0.0
This server cannot be installed