富果 MCP 服务

富果 MCP (模型上下文协议) 服务，用于与富果交易系统进行交互。此服务支持股票行情查询和交易功能。

功能特点

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

安装

使用 NPM

npx fugle-mcp-server

使用 Docker

docker pull kevinypfan/fugle-mcp-server

使用方法

环境变量

服务需要以下环境变量：

• NATIONAL_ID: 身份证号
• NOTIONAL_ID: 身份证号（已弃用，请使用 NATIONAL_ID）
• ACCOUNT_PASS: 账户密码
• CERT_PASS: 证书密码
• CERT_PATH: 证书路径（仅 NPM 方式需要）
• ENABLE_ORDER: 是否开启下单功能（可选，默认为 false）

重要通知:

• 从版本 0.0.7 开始，我们将 NOTIONAL_ID 改名为 NATIONAL_ID。为了保持向后兼容性，两个环境变量目前都可以使用，但建议使用 NATIONAL_ID。
• 弃用计划: NOTIONAL_ID 将在版本 0.1.0 中被完全移除。请在此之前迁移到 NATIONAL_ID。

Docker 配置

在你的 .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": "<身份证号>",
        "ACCOUNT_PASS": "<账户密码>",
        "CERT_PASS": "<证书密码>",
        "ENABLE_ORDER": "<开启下单功能 ex: true 或 false>"
      }
    }
  }
}

NPM 配置

在你的 .mcp-config.json 中添加：

{
  "mcpServers": {
    "fugle-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "fugle-mcp-server"
      ],
      "env": {
        "NATIONAL_ID": "<身份证号>",
        "ACCOUNT_PASS": "<账户密码>",
        "CERT_PASS": "<证书密码>",
        "CERT_PATH": "<证书路径>",
        "ENABLE_ORDER": "<开启下单功能 ex: true 或 false>"
      }
    }
  }
}

命令行选项

• -v, --version: 显示版本信息