Skip to content
JimmyCui edited this page Aug 7, 2026 · 1 revision

Fubon API MCP Server 開發者 Wiki

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、壓力測試、配置最佳化、損益貢獻、價差、情緒、個股分析

完整名稱、參數摘要與風險分類請見 工具總覽

建議閱讀路徑

  1. 快速開始:完成安裝、認證與唯讀驗證。
  2. 設定與認證:選擇 PFX 或 API-Key 登入及 transport。
  3. MCP Client 設定:連接 VS Code 或其他 MCP Host。
  4. 工具總覽:確認工具名稱、輸入包裝與讀寫屬性。
  5. 依需求閱讀 市場資料工具交易工具帳戶、回報與分析
  6. 維護者請續讀 架構開發與測試

呼叫契約

服務方法以單一 args 物件接收業務參數。一般成功與失敗回應維持下列形狀:

{
  "status": "success",
  "data": {},
  "message": "成功訊息"
}
{
  "status": "error",
  "data": null,
  "message": "錯誤原因"
}

量化工具在正式資料不足時回傳 status: "error",並以 insufficient_data: 作為 message 前綴。呼叫端應保留此狀態,不得用假資料或預設數值補齊。

安全基線

  • .env、API Key、密碼、PFX 與帳戶資料不得提交至 Git。
  • 預設先使用唯讀工具驗證登入、帳戶選擇與行情時效。
  • place_*batch_place_ordermodify_*cancel_* 皆屬外部交易寫入。
  • 送單逾時代表結果未知,不代表失敗;重送前必須查詢委託與成交狀態。
  • 數量單位是「股」,1 張上市櫃股票通常為 1,000 股。
  • 遠端服務應限制網路邊界;預設 127.0.0.1 不應任意改為公開監聽。

相關連結

Clone this wiki locally