Fubon API MCP Server - VS Code Extension

富邦證券 MCP Server 的 VS Code Extension，提供完整的台股交易功能與市場數據查詢。

Extension ID: mofesto.fubon-api-mcp-server
Publisher: mofesto
Version: 2.1.0

✨ 功能特點

• 🚀 一鍵啟動: 在 VS Code 中直接啟動 Fubon MCP Server
• 🔧 便捷配置: 透過 VS Code 設定管理連線資訊
• 📊 即時日誌: 內建輸出面板顯示 server 運行狀態
• 🔄 快速重啟: 支援 server 的啟動、停止、重啟操作
• 🔒 安全輸入: 密碼輸入不會被儲存在設定檔中

📋 安裝需求

• VS Code 1.80.0 或更高版本
• Python 3.10 或更高版本
• fubon-api-mcp-server Python 套件

🚀 快速開始

1. 安裝 Extension

方式一：從 Marketplace 安裝（推薦）

Extension ID: mofesto.fubon-api-mcp-server

1. 打開 VS Code
2. 按 Ctrl+Shift+X (或 Cmd+Shift+X) 打開擴展面板
3. 搜尋 "Fubon API MCP Server"
4. 找到 Publisher 為 mofesto 的擴展
5. 點擊 "Install" 按鈕

或直接訪問 Marketplace：
https://marketplace.visualstudio.com/items?itemName=mofesto.fubon-api-mcp-server

方式二：手動安裝 VSIX

從 GitHub Releases 下載 .vsix 檔案：

# 在 VS Code 中：
# Extensions 面板 > ... (更多操作) > Install from VSIX...
# 選擇下載的 .vsix 檔案

2. 安裝 Python 套件

pip install fubon-api-mcp-server

3. 配置 Extension

按 Ctrl+, (或 Cmd+,) 打開設定，搜尋 "Fubon MCP"：

• Fubon Mcp: Username: 您的富邦證券帳號
• Fubon Mcp: Pfx Path: PFX 憑證檔案的完整路徑
• Fubon Mcp: Data Dir: 本地數據儲存目錄 (選填)
• Fubon Mcp: Auto Start: VS Code 啟動時自動啟動 server (選填)

重要：首次使用請在命令面板執行一次「Fubon MCP: Configure」（或「Configure Fubon MCP Server」）。未執行此步驟，Copilot Chat 可能無法於 MCP Server 中註冊工具，導致 @fubon-api 工具清單不可用或無法被呼叫。

4. 啟動 Server

按 Ctrl+Shift+P (或 Cmd+Shift+P) 打開命令面板，輸入：

• Fubon MCP: Start Fubon MCP Server - 啟動 server
• Fubon MCP: Stop Fubon MCP Server - 停止 server
• Fubon MCP: Restart Fubon MCP Server - 重啟 server
• Fubon MCP: Show Fubon MCP Server Logs - 顯示日誌

⚙️ 設定項目

📖 使用範例

在 settings.json 中配置

{
  "fubon-mcp.username": "A123456789",
  "fubon-mcp.pfxPath": "C:\\Users\\YourName\\cert.pfx",
  "fubon-mcp.dataDir": "D:\\FubonData",
  "fubon-mcp.autoStart": false
}

命令面板操作

1. 啟動 Server: Ctrl+Shift+P → "Fubon MCP: Start"
2. 輸入密碼: 彈出對話框輸入帳號密碼和憑證密碼
3. 檢視日誌: Ctrl+Shift+P → "Fubon MCP: Show Logs"
4. 停止 Server: Ctrl+Shift+P → "Fubon MCP: Stop"

🔒 安全性說明

• ✅ 帳號密碼不會儲存在設定檔中
• ✅ 每次啟動時需要重新輸入密碼
• ✅ 密碼輸入框使用遮罩保護
• ✅ 密碼僅存在於 server 運行期間的記憶體中

🐛 故障排查

Server 無法啟動

1. 確認 Python 環境正確: python --version
2. 確認套件已安裝: pip list | grep fubon-api-mcp-server
3. 檢查設定檔路徑是否正確
4. 查看輸出面板的錯誤訊息

連線失敗

1. 確認富邦證券帳號和密碼正確
2. 確認 PFX 憑證檔案有效
3. 確認網路連線正常
4. 查看 server 日誌了解詳細錯誤

找不到 Python

Extension 使用系統預設的 python 命令。如需指定 Python 路徑：

1. 確保 Python 在系統 PATH 中
2. 或修改 extension.js 中的 spawn('python', ...) 為完整路徑

📚 相關資源

• VS Code Marketplace: https://marketplace.visualstudio.com/items?itemName=mofesto.fubon-api-mcp-server

• PyPI 套件: https://pypi.org/project/fubon-api-mcp-server/

• GitHub 專案: https://github.com/Mofesto/fubon-api-mcp-server

• 問題回報: https://github.com/Mofesto/fubon-api-mcp-server/issues

• 富邦 API 文檔: https://www.fbs.com.tw/TradeAPI/docs/

🤝 貢獻

歡迎提交 Pull Request 或回報問題！

☕ 支持專案

如果這個 Extension 對您有幫助，歡迎請我喝杯咖啡支持開發！

掃描 QR Code 支持專案

開發者資訊

• Extension ID: mofesto.fubon-api-mcp-server
• Publisher: mofesto
• Repository: https://github.com/Mofesto/fubon-api-mcp-server
• Marketplace: https://marketplace.visualstudio.com/publishers/mofesto

📄 授權

MIT License

⚠️ 免責聲明

• 本 extension 非富邦證券官方產品
• 使用本軟體需自行承擔風險
• 請遵守相關金融法規和平台使用條款

開發者: Mofesto.Cui
Publisher: mofesto
Extension ID: mofesto.fubon-api-mcp-server
版本: 2.1.0
最後更新: 2025-11-04