-
Notifications
You must be signed in to change notification settings - Fork 5
Home
JimmyCui edited this page Aug 7, 2026
·
1 revision
Fubon API MCP Server 是一個社群維護的 Model Context Protocol(MCP)伺服器,將富邦證券官方 fubon_neo Python SDK 封裝成可由 MCP Host 呼叫的台股、期貨/選擇權、帳戶、委託回報與量化分析工具。
Important
本專案不是富邦證券官方產品。任何交易結果均受帳戶權限、交易時段、市場狀態、網路與券商回應影響。正式環境中應先完成唯讀查詢與回讀驗證,再明確授權交易寫入。
本 Wiki 依 v2.2.8 程式碼與 MCP discovery 實際盤點:
| 項目 | 目前實作 |
|---|---|
| Python | 3.10–3.13 |
| 富邦 SDK | fubon_neo >=2.2.8,<2.2.9 |
| MCP Python SDK | mcp >=2.0.0,<3.0.0 |
| MCP protocol revision | 2026-07-28 |
| MCP tools | 72 |
| MCP prompts | 12 |
| 傳輸 | stdio、Streamable HTTP、SSE |
| 授權 | Apache-2.0 |
| 領域 | 數量 | 能力摘要 | 是否可能寫入交易 |
|---|---|---|---|
| 市場資料 | 28 | 台股即時/快照/歷史行情、股務事件、期貨選擇權行情、技術訊號 | 否 |
| 交易與委託 | 24 | 普通單、批次單、條件單、當沖、分時分量、移動鎖利、委託查詢 | 部分工具會 |
| 帳戶 | 8 | 帳戶、庫存、銀行餘額、維持率、交割與損益 | 否 |
| 主動回報 | 5 | 委託、改單、成交、事件的記憶體內最新回報 | 否 |
| 量化分析 | 7 | VaR/CVaR、壓力測試、配置最佳化、損益貢獻、價差、情緒、個股分析 | 否 |
完整名稱、參數摘要與風險分類請見 工具總覽。
- 快速開始:完成安裝、認證與唯讀驗證。
- 設定與認證:選擇 PFX 或 API-Key 登入及 transport。
- MCP Client 設定:連接 VS Code 或其他 MCP Host。
- 工具總覽:確認工具名稱、輸入包裝與讀寫屬性。
- 依需求閱讀 市場資料工具、交易工具 或 帳戶、回報與分析。
- 維護者請續讀 架構 與 開發與測試。
服務方法以單一 args 物件接收業務參數。一般成功與失敗回應維持下列形狀:
{
"status": "success",
"data": {},
"message": "成功訊息"
}{
"status": "error",
"data": null,
"message": "錯誤原因"
}量化工具在正式資料不足時回傳 status: "error",並以 insufficient_data: 作為 message 前綴。呼叫端應保留此狀態,不得用假資料或預設數值補齊。
-
.env、API Key、密碼、PFX 與帳戶資料不得提交至 Git。 - 預設先使用唯讀工具驗證登入、帳戶選擇與行情時效。
-
place_*、batch_place_order、modify_*、cancel_*皆屬外部交易寫入。 - 送單逾時代表結果未知,不代表失敗;重送前必須查詢委託與成交狀態。
- 數量單位是「股」,1 張上市櫃股票通常為 1,000 股。
- 遠端服務應限制網路邊界;預設
127.0.0.1不應任意改為公開監聽。
Fubon API MCP Server v2.2.8 · MCP 2026-07-28 · Repository · Issues · Apache-2.0
社群專案,非富邦證券官方產品。交易前請確認參數、帳戶權限與最終券商狀態。