Fugle MCP Server

🚀 Fugle MCP Server

The Fugle MCP (Model Context Protocol) Server is used to interact with the Fugle trading system. This service supports stock market quotes query and trading functions.

✨ Features

• Support real-time stock market quotes query
• Support historical data query
• Support trading functions (optional)
• Support two deployment methods: Docker and NPM
• Fully compatible with the MCP protocol

📦 Installation

Using NPM

npx fugle-mcp-server

Using Docker

docker pull kevinypfan/fugle-mcp-server

💻 Usage Examples

Environment Variables

The service requires the following environment variables:

• NATIONAL_ID: National ID number
• NOTIONAL_ID: National ID number (deprecated, please use NATIONAL_ID)
• ACCOUNT_PASS: Account password
• CERT_PASS: Certificate password
• CERT_PATH: Certificate path (only required for the NPM method)
• ENABLE_ORDER: Whether to enable the order placement function (optional, default is false)

⚠️ Important Note

• Starting from version 0.0.7, we renamed NOTIONAL_ID to NATIONAL_ID. For backward compatibility, both environment variables can currently be used, but it is recommended to use NATIONAL_ID.
• Deprecation Plan: NOTIONAL_ID will be completely removed in version 0.1.0. Please migrate to NATIONAL_ID before then.

Docker Configuration

Add the following to your .mcp-config.json:

{
  "mcpServers": {
    "fugle-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--platform=linux/amd64",
        "-i",
        "--rm",
        "-e",
        "NATIONAL_ID",
        "-e",
        "ACCOUNT_PASS",
        "-e",
        "CERT_PASS",
        "-e",
        "ENABLE_ORDER",
        "--mount", "type=bind,src=</path/to/cert.p12>,dst=/app/cert.p12",
        "kevinypfan/fugle-mcp-server"
      ],
      "env": {
        "NATIONAL_ID": "<National ID number>",
        "ACCOUNT_PASS": "<Account password>",
        "CERT_PASS": "<Certificate password>",
        "ENABLE_ORDER": "<Enable order placement function ex: true or false>"
      }
    }
  }
}

NPM Configuration

Add the following to your .mcp-config.json:

{
  "mcpServers": {
    "fugle-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "fugle-mcp-server"
      ],
      "env": {
        "NATIONAL_ID": "<National ID number>",
        "ACCOUNT_PASS": "<Account password>",
        "CERT_PASS": "<Certificate password>",
        "CERT_PATH": "<Certificate path>",
        "ENABLE_ORDER": "<Enable order placement function ex: true or false>"
      }
    }
  }
}

📚 Documentation

Command-line Options

• -v, --version: Display version information