What is Fugle Mcp Server

Fugle MCP Server is a server designed for interaction with the Fugle trading system, supporting stock market queries and trading functionalities.

Use cases

Use cases include real-time stock price monitoring, historical data analysis for investment strategies, and automated trading systems that require integration with the Fugle trading platform.

How to use

You can use Fugle MCP Server either via NPM by running ‘npx fugle-mcp-server’ or through Docker by pulling the image ‘docker pull kevinypfan/fugle-mcp-server’. Make sure to set the required environment variables before starting the server.

Key features

Key features include real-time stock market queries, historical data retrieval, optional trading functionalities, support for both Docker and NPM deployment, and full compatibility with the MCP protocol.

Where to use

Fugle MCP Server is primarily used in financial technology sectors, particularly for applications involving stock trading and market analysis.

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

富果 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 類型（可選：「元富(masterlink)」或「富邦(fubon)」，預設為「元富(masterlink)」）
• NATIONAL_ID: 身分證字號
• ACCOUNT_PASS: 帳戶密碼
• CERT_PASS: 憑證密碼
• CERT_PATH: 憑證檔案路徑
• ENABLE_ORDER: 是否開啟下單功能（可選，預設為 false）
• ACCOUNT: 如有多帳戶，可以使用此參數指定登入帳戶（可選，預設為第一個帳戶）

ℹ️ 元富帳號範例 ： 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",
        "--mount",
        "type=bind,src=</path/to/cert.p12>,dst=/app/cert.p12",
        "fugle/mcp-server"
      ],
      "env": {
        "SDK_TYPE": "masterlink|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": "masterlink|fubon",
        "NATIONAL_ID": "您的身分證字號",
        "ACCOUNT_PASS": "您的帳戶密碼",
        "CERT_PASS": "您的憑證密碼",
        "CERT_PATH": "/path/to/your/cert.p12",
        "ENABLE_ORDER": "false",
        "ACCOUNT": "指定使用帳戶號碼"
      }
    }
  }
}