fugle

Fugle MCP Server provides a specialized interface to interact with the Fugle trading system using the MCP protocol. It supports real-time stock quotes, historical data queries, and optional trading functionality. You can run the server either via NPM (npx) or Docker, and configure access using environment variables such as your investor credentials, certificate paths, and connection settings. Once started, the MCP server exposes standard MCP endpoints that other tools and adapters can consume to request quotes, request historical data, or submit trades when ENABLE_ORDER is enabled. The environment variable SDK_TYPE lets you choose between masterlink and fubon SDKs, and CERT_PATH/CERT_PASS along with National ID authenticate and establish secure connections with Fugle services. Use ACCOUNT to select a specific account if you have multiple accounts configured.

Prerequisites:

• Node.js and npm installed for NPM mode (or Docker for containerized deployment).
• Access credentials and certificates as described in the README (NATIONAL_ID, ACCOUNT_PASS, CERT_PATH, CERT_PASS).

Install via NPM (preferred for local development):

1. Ensure Node.js and npm are installed on your system.
2. Run:

npm install -g @fugle/mcp-server

3. Start using MCP by invoking npx as shown in the configuration:

npx -y @fugle/mcp-server

Install via Docker:

1. Ensure Docker is installed and running.
2. Pull the Fugle MCP Server image:

docker pull fugle/mcp-server

3. Run the container with required environment variables:

docker run -it --rm \
  -e SDK_TYPE=masterlink \
  -e NATIONAL_ID=YourID \
  -e ACCOUNT_PASS=YourPassword \
  -e CERT_PASS=YourCertPass \
  -e ENABLE_ORDER=false \
  -e ACCOUNT=YourAccount \
  -e CERT_PATH=/path/to/your/cert.p12 \
  -v /path/to/cert:/path/to/cert:ro \
  fugle/mcp-server

Note: If you plan to run in production, consider using the official .mcp-config.json snippet from the README to configure your deployment with either npm or Docker in a repeatable way.

Tips and considerations:

• Ensure CERT_PATH points to a valid certificate file and that your CERT_PASS matches the certificate.
• If you have multiple accounts, use ACCOUNT to specify which one to log into; otherwise the first account will be used.
• ENABLE_ORDER controls trading capability; set it to true only if your environment and credentials support placing orders.
• When using Docker, bind any certificate file paths appropriately and consider mounting a volume for certificates to avoid embedding sensitive data in the image.
• SDK_TYPE 선택은 masterlink 혹은 fubon 중 하나를 사용; 환경에 맞는 값을 설정하세요. 기본값은 masterlink입니다.
• For troubleshooting, check environment variable propagation inside container or shell environment where you run npx; some shells may strip variables if not exported.