Fugle MCP Server（目前仅支持证券交易功能）

功能特性

• 支持实时股市查询
• 支持历史数据查询
• 支持交易功能（可选）
• 支持 Docker 和 NPM 两种部署方式
• 完全兼容 MCP 协议

预备工作

安装 NPM

前往 Node.js 官方网站 下载 对应的操作系统平台版本。

申请凭证

元富证券，请使用 在线凭证申请 或下载 凭证电子管家 申请凭证

⚠️ 对于在线申请凭证的用户，凭证密码预设为您的身份证号

富邦证券，请下载 TCEM 凭证管理工具 申请凭证

⚠️ 此工具仅支持 Windows 平台，如果您使用的是 Mac 或 Linux，请先在 Windows 上完成申请，然后将文件移动到 Mac 或 Linux 系统上

安装

使用 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（包括分公司代码）
ℹ️ 富邦账户示例：1234556（无需包含分公司代码）

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": "指定使用的账户号码"
      }
    }
  }
}