Fugle

Provides stock quotes, historical data, and optional trading via MCP protocol with Docker and NPM deployment options.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kevinypfan-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": {
        "ACCOUNT": "指定使用帳戶號碼",
        "SDK_TYPE": "masterlink|fubon",
        "CERT_PASS": "您的憑證密碼",
        "CERT_PATH": "/path/to/your/cert.p12",
        "NATIONAL_ID": "您的身分證字號",
        "ACCOUNT_PASS": "您的帳戶密碼",
        "ENABLE_ORDER": "false"
      }
    }
  }
}

The Fugle MCP Server enables programmatic access to stock quotes, historical data, and optional trading interactions within the Fugle trading ecosystem. It acts as a bridge that lets clients query live and historical market data and, if enabled, place trades through MCP-compatible requests.

How to use

You connect an MCP client to the Fugle MCP Server to fetch real-time stock prices, query historical data, and, if you enable trading, submit orders. Use the client to request data from the server and receive structured responses that conform to the MCP protocol. Ensure you supply the required authentication and account information when trading is enabled.

How to install

Prerequisites you need before starting: node runtime for npm-based deployment, or Docker if you prefer containerized deployment.

Install using NPM (dev or local development flow):

# Run the MCP server directly with npx
npx @fugle/mcp-server

Install using Docker (containerized deployment):

docker pull fugle/mcp-server

Configuration, security, and deployment notes

The server uses environment variables to configure identity, authentication, and features. You can run the server via Docker or via npm/npx. Below are the two explicit configuration approaches and the environment variables you should provide to run securely and correctly.

{
  "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": "指定使用帳戶號碼"
      }
    }
  }
}

{
  "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": "指定使用帳戶號碼"
      }
    }
  }
}

Built by

VeilStrat

AI signals for GTM teams