Fubon MCP Server

基本能力

產品定位

富邦證券市場資料 MCP 伺服器，專為獲取台股歷史數據設計。

核心功能

• 支援台股及 ETF 歷史 K 線數據查詢
• 本地數據快取，減少 API 呼叫次數
• 自動分段處理長時間區間的數據請求
• 支援數據去重和排序
• 提供額外計算欄位（成交值、漲跌、漲跌幅）

適用場景

• 金融分析
• 投資決策
• 數據研究

工具列表

• historical_candles: 獲取歷史 K 線數據
• GET twstock://{symbol}/historical: 查詢本地歷史數據

常見問題解答

• 請妥善保管您的富邦證券帳號密碼和電子憑證
• 建議設定適當的數據快取目錄
• API 呼叫可能有每日次數限制
• 長時間區間的數據會自動分段請求

使用教程

使用依賴

• Python 3.8 或以上版本
• 富邦證券電子憑證
• macOS / Linux / Windows

安裝教程

1. 克隆專案：

git clone https://github.com/yourusername/fubon-mcp-server.git
cd fubon-mcp-server

1. 建立虛擬環境：

python3 -m venv .venv
source .venv/bin/activate  # macOS/Linux
# 或
.venv\Scripts\activate  # Windows

1. 安裝相依套件：

pip install -r requirements.txt

1. 設定環境變數： 將以下環境變數加入到 .env 檔案：

FUBON_USERNAME=您的富邦證券帳號
FUBON_PASSWORD=您的富邦證券密碼
FUBON_PFX_PATH=/path/to/your/certificate.pfx
FUBON_DATA_DIR=/path/to/your/data/directory

調試方式

1. 啟動伺服器：

python server.py

1. 在 VS Code 中設定 MCP： 在 VS Code 的設定檔中加入：

{
  "mcpServers": {
    "fubon-mcp-server": {
      "command": "/path/to/your/.venv/bin/python3",
      "args": ["/path/to/your/server.py"],
      "env": {
        "FUBON_USERNAME": "您的富邦證券帳號",
        "FUBON_PASSWORD": "您的富邦證券密碼",
        "FUBON_PFX_PATH": "/path/to/your/certificate.pfx",
        "FUBON_DATA_DIR": "/path/to/your/data/directory"
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。