mcpField
F
Fubon MCP Server

Fubon MCP Server

Local
github.com/mingyawFinance2Updated 83w ago
Repository

About Fubon MCP Server

Fubon MCP Server provides historical Taiwan stock and ETF data through Fubon Securities. It caches results locally and handles long date ranges in segmented requests.

Key features

  1. 01Historical stock and ETF candles
  2. 02Local data caching
  3. 03Automatic date-range segmentation
  4. 04Deduplication and sorting
  5. 05Calculated trading value and price changes

Use cases

  1. 01Retrieve historical candles for a Taiwan stock
  2. 02Query locally cached historical data
  3. 03Analyze price changes over a date range

MCP support

The MCP server exposes historical candle queries and a `twstock://{symbol}/historical` resource for locally stored data.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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
  • 初始版本發布
  • 支援基本的歷史數據查詢
  • 實作本地數據快取

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.