fugle-mcp-server

# Fugle MCP Server (Currently only supports securities functions) <!--     --> <!--  --> Fugle MCP (Model Context Protocol) server for interacting with the Fugle trading system. This server supports stock market query and trading functions. ## Features - Supports real-time stock market queries - Supports historical data queries - Supports trading functions (optional) - Supports deployment via Docker and NPM - Fully compatible with the MCP protocol ## Prerequisites ### Install NPM Download the corresponding operating system platform from the official [Node.js download page](https://nodejs.org/en/download). ## Apply for Credentials ### For Yuanta Securities, please use the [online certificate application](https://ml-fugle-api.masterlink.com.tw/FugleSDK/docs/key/) or download the [Certificate e-Manager](https://www.masterlink.com.tw/certificate-eoperation) to apply for credentials. ⚠️ For users applying for credentials online, the default certificate password is your national ID number. ### For Fubon Securities, please download the [TCEM Certificate Management Tool](https://www.fbs.com.tw/Certificate/Management/) to apply for credentials. ⚠️ This tool only supports Windows platform. If you are using Mac or Linux, please apply on Windows first, then transfer the files to your Mac or Linux system. ## Installation ### Using NPM ```bash npx @fugle/mcp-server ``` ### Using Docker ```bash docker pull fugle/mcp-server ``` ## Usage ### Environment Variables The server requires the following environment variables: - `SDK_TYPE`: The SDK type used by the MCP Server (optional: "Yuanta (masterlink)" or "Fubon", default is "Yuanta (masterlink)") - `NATIONAL_ID`: National ID number - `ACCOUNT_PASS`: Account password - `CERT_PASS`: Certificate password - `CERT_PATH`: Path to the certificate file - `ENABLE_ORDER`: Whether to enable the order function (optional, default is false) - `ACCOUNT`: If there are multiple accounts, this parameter can be used to specify the login account (optional, default is the first account) ℹ️ Example of Yuanta account: 592a12345678 (including branch code) ℹ️ Example of Fubon account: 1234456 (no need to include branch code) ### Docker Configuration Add the following to your `.mcp-config.json`: ```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": "Your national ID number", "ACCOUNT_PASS": "Your account password", "CERT_PASS": "Your certificate password", "ENABLE_ORDER": "false", "ACCOUNT": "Specify the account number to use" } } } } ``` ### NPM Configuration Add the following to your `.mcp-config.json`: ```json { "mcpServers": { "@fugle/mcp-server": { "command": "npx", "args": [ "-y", "@fugle/mcp-server" ], "env": { "SDK_TYPE": "masterlink|fubon", "NATIONAL_ID": "Your national ID number", "ACCOUNT_PASS": "Your account password", "CERT_PASS": "Your certificate password", "CERT_PATH": "/path/to/your/cert.p12", "ENABLE_ORDER": "false", "ACCOUNT": "Specify the account number to use" } } } } ```