Fugle MCP Server

富果 MCP (Model Context Protocol) 服務器，用於與富果交易系統進行互動。此服務器支持股票行情查詢和交易功能。

功能特點

• 支持股票即時行情查詢
• 支持歷史數據查詢
• 支持交易功能（可選）
• 支持 Docker 和 NPM 兩種部署方式
• 完全兼容 MCP 協議

安裝

使用 NPM

npx fugle-mcp-server

使用 Docker

docker pull kevinypfan/fugle-mcp-server

使用方法

環境變量

服務器需要以下環境變量：

• NOTIONAL_ID: 身分證字號
• ACCOUNT_PASS: 帳戶密碼
• CERT_PASS: 憑證密碼
• CERT_PATH: 憑證位置（僅 NPM 方式需要）
• ENABLE_ORDER: 是否開啟下單功能（可選，預設為 false）

Docker 配置

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

{
  "mcpServers": {
    "fugle-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--platform=linux/amd64",
        "-i",
        "--rm",
        "-e",
        "NOTIONAL_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": {
        "NOTIONAL_ID": "<身分證字號>",
        "ACCOUNT_PASS": "<帳戶密碼>",
        "CERT_PASS": "<憑證密碼>",
        "ENABLE_ORDER": "<開啟下單功能 ex: true or false>"
      }
    }
  }
}

NPM 配置

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

{
  "mcpServers": {
    "fugle-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "fugle-mcp-server"
      ],
      "env": {
        "NOTIONAL_ID": "<身分證字號>",
        "ACCOUNT_PASS": "<帳戶密碼>",
        "CERT_PASS": "<憑證密碼>",
        "CERT_PATH": "<憑證位置>",
        "ENABLE_ORDER": "<開啟下單功能 ex: true or false>"
      }
    }
  }
}

命令行選項

• -v, --version: 顯示版本號

版本

當前版本：0.0.5

貢獻

歡迎提交 Issue 和 Pull Request。

授權

MIT License