Fugle Masterlink (Taiwan Stock Market)

by kevinypfan

8 stars
258 downloads
Not rated
GitHub

About

Provides a bridge between AI systems and the Masterlink SDK for Taiwan stock market trading, enabling account management, market data retrieval, and trade execution for financial analysis and automated trading strategies.

Details

Author
kevinypfan
Repository
fugle-dev/fugle-mcp-server
GitHub stars
8
Downloads
258
License
MIT License
Categories
Design, Developer Tools, AI, Infrastructure, Automation, Frontend, Security, Other

- Real‑time stock quote queries
- Historical stock data queries
- Optional trading functionality (disabled by default)
- Supports Taishin and Fubon securities brokers
- Deployable via Docker and NPM

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Fugle Masterlink (Taiwan Stock Market)
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @fugle/mcp-server
    Environment
    • ACCOUNT 指定使用帳戶號碼
    • SDK_TYPE taishin|fubon
    • CERT_PASS 您的憑證密碼
    • CERT_PATH /path/to/your/cert.p12
    • NATIONAL_ID 您的身分證字號
    • ACCOUNT_PASS 您的帳戶密碼
    • ENABLE_ORDER false

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via npm (npx @fugle/mcp-server) or Docker (docker pull fugle/mcp-server). Configure environment variables for your broker credentials, certificate path, and optional settings, then add the server to your MCP JSON configuration as shown in the README.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "fugle masterlink (taiwan stock market)": {
            "env": {
                "ACCOUNT": "\u6307\u5b9a\u4f7f\u7528\u5e33\u6236\u865f\u78bc",
                "SDK_TYPE": "taishin|fubon",
                "CERT_PASS": "\u60a8\u7684\u6191\u8b49\u5bc6\u78bc",
                "CERT_PATH": "/path/to/your/cert.p12",
                "NATIONAL_ID": "\u60a8\u7684\u8eab\u5206\u8b49\u5b57\u865f",
                "ACCOUNT_PASS": "\u60a8\u7684\u5e33\u6236\u5bc6\u78bc",
                "ENABLE_ORDER": "false"
            },
            "args": [
                "-y",
                "@fugle/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "ACCOUNT": "\u6307\u5b9a\u4f7f\u7528\u5e33\u6236\u865f\u78bc",
        "SDK_TYPE": "taishin|fubon",
        "CERT_PASS": "\u60a8\u7684\u6191\u8b49\u5bc6\u78bc",
        "CERT_PATH": "/path/to/your/cert.p12",
        "NATIONAL_ID": "\u60a8\u7684\u8eab\u5206\u8b49\u5b57\u865f",
        "ACCOUNT_PASS": "\u60a8\u7684\u5e33\u6236\u5bc6\u78bc",
        "ENABLE_ORDER": "false"
    },
    "args": [
        "-y",
        "@fugle/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "ACCOUNT": "\u6307\u5b9a\u4f7f\u7528\u5e33\u6236\u865f\u78bc",
        "SDK_TYPE": "taishin|fubon",
        "CERT_PASS": "\u60a8\u7684\u6191\u8b49\u5bc6\u78bc",
        "CERT_PATH": "/path/to/your/cert.p12",
        "NATIONAL_ID": "\u60a8\u7684\u8eab\u5206\u8b49\u5b57\u865f",
        "ACCOUNT_PASS": "\u60a8\u7684\u5e33\u6236\u5bc6\u78bc",
        "ENABLE_ORDER": "false"
    },
    "args": [
        "-y",
        "@fugle/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "ACCOUNT": "\u6307\u5b9a\u4f7f\u7528\u5e33\u6236\u865f\u78bc",
        "SDK_TYPE": "taishin|fubon",
        "CERT_PASS": "\u60a8\u7684\u6191\u8b49\u5bc6\u78bc",
        "CERT_PATH": "/path/to/your/cert.p12",
        "NATIONAL_ID": "\u60a8\u7684\u8eab\u5206\u8b49\u5b57\u865f",
        "ACCOUNT_PASS": "\u60a8\u7684\u5e33\u6236\u5bc6\u78bc",
        "ENABLE_ORDER": "false"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "@fugle/mcp-server"
    ],
    "command": "cmd"
}

Fugle MCP Server ( 目前僅支援證券功能 )

<!-- Docker Pulls Docker Image Size NPM Version NPM Downloads --> <!-- License --> 富果 MCP (Model Context Protocol) 伺服器,用於與富果交易系統進行互動。此伺服器支援股票行情查詢和交易功能。

功能特點

- 支援股票即時行情查詢 - 支援歷史數據查詢 - 支援交易功能(可選) - 支援 Docker 和 NPM 兩種部署方式 - 完全兼容 MCP 協議

前置作業

安裝 NPM

到 Node.js 官方 下載 對應的作業系統平台

申請憑證

台新證券請使用 憑證 e 管家 來申請憑證

⚠️ 使用線上申請憑證之用戶,憑證密碼預設為您的身分證字號

富邦證券請下載 TCEM 憑證管理工具 來申請憑證

⚠️ 此工具僅支援 windows 平台,若您使用 Mac or Linux 請先至 Windows 申請完後,再將檔案移轉到 Mac or Lixux 系統上

安裝

使用 NPM

npx @fugle/mcp-server

使用 Docker

docker pull fugle/mcp-server

使用方法

環境變數

伺服器需要以下環境變數: - SDK_TYPE: MCP Server 使用 SDK 類型(可選:「台新(taishin)」或「富邦(fubon)」,預設為「台新(taishin)」) - NATIONAL_ID: 身分證字號 - ACCOUNT_PASS: 帳戶密碼 - CERT_PASS: 憑證密碼 - CERT_PATH: 憑證檔案路徑 - ENABLE_ORDER: 是否開啟下單功能(可選,預設為 false) - ACCOUNT: 如有多帳戶,可以使用此參數指定登入帳戶(可選,預設為第一個帳戶) - FUBON_URL: 富邦 SDK 連線 URL(可選,僅適用於 fubon,用於連線測試伺服器)

ℹ️ 台新帳號範例 : 592a12345678 ( 包含分公司代碼 )
ℹ️ 富邦帳號範例 : 1234456 ( 不需包含分公司代碼 )

Docker 配置

在您的 .mcp-config.json 中添加:

{
"mcpServers": {
"@fugle/mcp-server": {
"command": "docker",
"args": [
"run",
"--platform=linux/amd64",
"-i",
"--rm",
"-e",
"SDK_TYPE",
"-e",
"NATIONAL_ID",
"-e",
"ACCOUNT_PASS",
"-e",
"CERT_PASS",
"-e",
"ENABLE_ORDER",
"-e",
"ACCOUNT",
"-e",
"FUBON_URL",
"--mount", "type=bind,src=</path/to/cert.p12>,dst=/app/cert.p12",
"fugle/mcp-server"
],
"env": {
"SDK_TYPE": "taishin|fubon",
"NATIONAL_ID": "您的身分證字號",
"ACCOUNT_PASS": "您的帳戶密碼",
"CERT_PASS": "您的憑證密碼",
"ENABLE_ORDER": "false",
"ACCOUNT": "指定使用帳戶號碼"
}
}
}
}

NPM 配置


在您的 .mcp-config.json 中添加:
{
"mcpServers": {
"@fugle/mcp-server": {
"command": "npx",
"args": [
"-y",
"@fugle/mcp-server"
],
"env": {
"SDK_TYPE": "taishin|fubon",
"NATIONAL_ID": "您的身分證字號",
"ACCOUNT_PASS": "您的帳戶密碼",
"CERT_PASS": "您的憑證密碼",
"CERT_PATH": "/path/to/your/cert.p12",
"ENABLE_ORDER": "false",
"ACCOUNT": "指定使用帳戶號碼"
}
}
}
}

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.