Fubon MCP Server

Name: Fubon MCP Server
Author: mingyaw

@mingyaw

Repository

About Fubon MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "fubon-mcp-server": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Fubon MCP Server?

Fubon MCP Server is a Model Communication Protocol server for retrieving historical market data of Taiwan stocks (臺股). It is designed for users who need automated access to stock and ETF price history, requiring a Fubon Securities account and electronic certificate.

How to use Fubon MCP Server?

Install Python 3.8+, clone the repository, create a virtual environment, install dependencies via pip install -r requirements.txt, and set environment variables (FUBON_USERNAME, FUBON_PASSWORD, FUBON_PFX_PATH, FUBON_DATA_DIR). Start the server with python server.py and configure it in VS Code’s MCP settings under mcpServers.

Key features of Fubon MCP Server

Supports historical K‑line data for Taiwan stocks and ETFs.
Local data caching reduces API calls.
Automatically splits long date ranges into segments.
Deduplicates and sorts data.
Provides extra calculated fields (turnover, change, change percentage).

Use cases of Fubon MCP Server

Backtesting trading strategies with historical Taiwan stock data.
Building custom analytics dashboards for Taiwanese equities.
Automating daily market data downloads for internal research.

FAQ from Fubon MCP Server

What are the system requirements?

Python 3.8 or later, a Fubon Securities account/electronic certificate, and macOS, Linux, or Windows.

How is data stored and accessed?

Data is cached locally in the directory specified by FUBON_DATA_DIR. Historical data can be queried via the historical_candles tool and also via the twstock://{symbol}/historical URI across MCP.

Are there any API call limits?

Yes, the API may have daily call limits. The server handles long time ranges by automatically splitting requests into smaller segments.

What credentials are needed?

A Fubon Securities username, password, and the path to a personal .pfx certificate file. These must be kept secure and configured as environment variables.