关键词

股票交易行情查询账户管理台湾股票Fugle

项目简介

Fugle MCP 伺服器是一个基于 Model Context Protocol (MCP) 的后端应用，旨在连接富果交易系统，为大语言模型 (LLM) 客户端提供台湾股票市场的实时行情、历史数据、公司基本面信息，以及账户查询和交易下单等功能。它支持多种部署方式（NPM、Docker）并兼容标准的 MCP 协议，使 LLM 能够通过工具调用与富果交易平台进行交互。

主要功能点

  • 股票市场数据查询： 提供股票实时报价、历史 K 线、成交明细、分價量表，以及依市場別查詢漲跌幅及成交量值排行等丰富的市场数据。
  • 公司及基本面信息： 查询上市公司/柜公司基本资料、近期重要日期、重大訊息公告、近5年月营收数据、历史股利信息等公司基本面数据。
  • 账户信息查询： 支持查询分户帐银行余额、股票库存持股、未实现/已实现损益明细及汇总、交割款信息、账户维持率等个人账户财务数据。
  • 交易功能： 如果启用交易功能，可以进行股票下单、修改委託价格、修改委託数量、刪除委託单，并查询当日未成交委託单和历史委託/成交单记录。

安装步骤

Fugle MCP 伺服器支持通过 NPM 或 Docker 两种方式安装和运行。

  • 使用 NPM 安装： 在您的终端中运行以下命令：

    npx fugle-mcp-server

    这会自动下载并运行服务器。

  • 使用 Docker 安装： 首先拉取 Docker 镜像：

    docker pull kevinypfan/fugle-mcp-server

    之后可以通过 Docker 容器运行服务器。

服务器配置 (MCP 客户端配置)

Fugle MCP 伺服器需要您的富果交易账户认证信息才能运行。这些信息通过环境变量传递。作为 MCP 客户端的使用者，您需要在客户端的配置文件（通常是 '.mcp-config.json'）中配置如何启动 Fugle MCP 伺服器进程，并设置这些必要的环境变量。

配置文件中需要指定服务器的启动命令 ('command')、参数 ('args') 以及运行所需的环境变量 ('env')。根据您选择的安装方式（NPM 或 Docker），配置会有所不同：

  • 必要的环境变量：

    • 'SDK_TYPE': 指定使用富果哪家券商的 SDK，例如填写 '"masterlink"' (元富) 或 '"fubon"' (富邦)。
    • 'NATIONAL_ID': 您的身分證字號。
    • 'ACCOUNT_PASS': 您的富果交易账户密码。
    • 'CERT_PASS': 您的电子凭证密码。
    • 'CERT_PATH': 您的电子凭证 (.p12 文件) 在服务器运行环境中的绝对路径。如果是使用 Docker，需要通过 Docker 的 volume mount 参数将本地凭证文件映射到容器内的指定路径（例如 '/app/cert.p12'），并将 'CERT_PATH' 设置为容器内的路径。
    • 'ENABLE_ORDER': 是否启用交易下单相关工具，设置为 '"true"' 启用，默认为 '"false"' 则只提供查询功能。
    • 'ACCOUNT' (可选): 如果您有多个交易账户，可以使用此参数指定要使用的账户号码，默认为第一个账户。

  • 配置示例说明： 您的 '.mcp-config.json' 文件中会包含一个条目来定义 Fugle MCP 伺服器。这个条目会指定 MCP 客户端如何启动服务器进程。例如：

    {
  "mcpServers": {
    "fugle-mcp-server": {
      // ... 启动命令和参数 (command/args) 根据 NPM 或 Docker 安装方式填写
      "env": {
        "SDK_TYPE": "masterlink 或 fubon",
        "NATIONAL_ID": "您的身分證字號",
        "ACCOUNT_PASS": "您的帳戶密碼",
        "CERT_PASS": "您的憑證密碼",
        "CERT_PATH": "/path/to/your/cert.p12" // 如果是Docker，这是容器内的路径
        "ENABLE_ORDER": "true 或 false",
        "ACCOUNT": "指定使用的帳戶號碼 (選填)"
      }
    }
  }
}

    请务必根据您实际的安装方式、凭证文件路径和账户信息填写正确的 'command', 'args', 和 'env' 配置。具体的 'command' 和 'args' 格式请参考 Fugle MCP 伺服器的官方 README 文件。

基本使用方法

  1. 准备 MCP 客户端： 安装并配置一个支持 Model Context Protocol 的 LLM 客户端。
  2. 配置 Fugle MCP 伺服器： 按照上述“服务器配置”说明，在您的 MCP 客户端配置文件中添加 Fugle MCP 伺服器的相关配置，包括启动命令和所有必需的环境变量。确保 'CERT_PATH' 指向正确的凭证文件位置，并且对于 Docker 安装，凭证文件已正确挂载到容器内。
  3. 启动客户端： 运行您的 MCP 客户端。客户端会根据配置启动 Fugle MCP 伺服器，并通过标准的 Stdio 传输协议与之建立连接。
  4. LLM 交互： 在客户端的聊天界面中，您可以向 LLM 提问或发出指令，例如：“帮我查询台积电（股票代码 2330）今天的即时报价”、“我的账户还有多少可用资金？”、“查询我上周的交易记录”。LLM 将识别这些请求，并调用 Fugle MCP 伺服器提供的相应工具（例如 'get_stock_intraday_quote', 'get_bank_remain', 'get_filled_history' 等）来获取信息或执行操作。如果启用了交易功能 ('ENABLE_ORDER=true')，您还可以指示 LLM 进行下单等操作。

信息

分类

商业系统

访问项目