Fubon MCP Server

Fubon MCP Server

By mingyaw GitHub

-

Overview

what is Fubon MCP Server?

Fubon MCP Server is a Model Communication Protocol server designed to retrieve historical stock data from Fubon Securities for the Taiwan stock market.

how to use Fubon MCP Server?

To use the Fubon MCP Server, clone the project from GitHub, set up a virtual environment, install the required dependencies, configure your environment variables, and then start the server.

key features of Fubon MCP Server?

  • Supports querying historical K-line data for Taiwan stocks and ETFs.
  • Local data caching to reduce API call frequency.
  • Automatic segmentation of long-duration data requests.
  • Supports data deduplication and sorting.
  • Provides additional calculated fields (transaction value, price change, percentage change).

use cases of Fubon MCP Server?

  1. Retrieving historical stock prices for analysis.
  2. Building financial applications that require real-time stock data.
  3. Conducting research on stock market trends using historical data.

FAQ from Fubon MCP Server?

  • What are the system requirements for Fubon MCP Server?

Python 3.8 or higher, Fubon Securities electronic certificate, and a compatible operating system (macOS, Linux, or Windows).

  • Is there a limit on API calls?

Yes, there may be daily limits on API calls, so it's advisable to manage your requests accordingly.

  • How do I secure my Fubon account credentials?

Ensure that your credentials and electronic certificate are stored securely and not exposed in public repositories.

Content

Fubon MCP Server

富邦證券市場資料 MCP (Model Communication Protocol) 伺服器，用於獲取台股歷史數據。

功能特點

  • 支援台股及 ETF 歷史 K 線數據查詢
  • 本地數據快取，減少 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"
      }
    }
  }
}

API 說明

取得歷史 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

  • 初始版本發布
  • 支援基本的歷史數據查詢
  • 實作本地數據快取
No tools information available.
No content found.