Fubon MCP Server

🚀 富邦證券市場資料 MCP 伺服器

富邦證券市場資料 MCP (Model Communication Protocol) 伺服器，主要用於獲取臺股歷史數據。它能有效幫助使用者便捷地查詢相關信息，提升數據獲取效率。

🚀 快速開始

富邦證券市場資料 MCP 伺服器可助力您輕鬆獲取臺股歷史數據。以下是使用前的準備步驟：

1. 確保您的系統符合以下要求：
   • Python 3.8 或以上版本
   • 擁有富邦證券電子憑證
   • 作業系統為 macOS / Linux / Windows

✨ 主要特性

• 支援臺股及 ETF 歷史 K 線數據查詢，讓您全面掌握市場走勢。
• 本地數據快取功能，可減少 API 呼叫次數，提升查詢效率。
• 自動分段處理長時間區間的數據請求，避免大數據量請求的問題。
• 支援數據去重和排序，保證數據的準確性和整潔性。
• 提供額外計算欄位（成交值、漲跌、漲跌幅），為您提供更詳細的市場信息。

📦 安裝指南

1. 克隆專案：

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

2. 建立虛擬環境：

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

3. 安裝相依套件：

pip install -r requirements.txt

4. 設定環境變數： 將以下環境變數加入到 .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

2. 在 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"
      }
    }
  }
}

📚 詳細文檔

取得歷史 K 線數據

historical_candles({
    "symbol": "2330",      # 股票代碼
    "from_date": "2024-03-01",  # 起始日期
    "to_date": "2024-03-24"     # 結束日期
})

查詢本地歷史數據

GET twstock://{symbol}/historical

⚠️ 注意事項

⚠️ 重要提示

請妥善保管您的富邦證券帳號密碼和電子憑證，API 呼叫可能有每日次數限制，長時間區間的數據會自動分段請求。

💡 使用建議

建議設定適當的數據快取目錄，以提升查詢效率。

📄 許可證

本項目採用 MIT License 授權。

🤝 貢獻指南

歡迎提交 Issue 和 Pull Request，共同完善本項目。

👨‍💻 作者

Hans Li
https://medium.com/@mingyawli

📝 更新日誌

v0.1.0

• 初始版本發布
• 支援基本的歷史數據查詢
• 實作本地數據快取