GMO Coin FX MCP Server

gmocoin-mcp

MCP 客户端注册

使用 stdio 或 HTTP 将服务注册到 MCP 客户端。 下面的本地检出示例使用 /path/to/gmocoin-fx-mcp；请将其替换为此仓库的绝对路径。

推荐：来自 GHCR 的 Docker 镜像

推荐通过 stdio 运行 GitHub Container Registry 发布的 Docker 镜像。 将以下条目添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "gmocoin-fx": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "GMO_API_KEY",
        "--env",
        "GMO_SECRET_KEY",
        "--env",
        "ORDER_SIZE_LIMIT",
        "--env",
        "ORDER_SYMBOL_LIMITS",
        "--env",
        "ORDER_CLIENT_ORDER_ID_PREFIX",
        "ghcr.io/rikitonoto/gmocoin-fx-mcp:latest"
      ],
      "env": {
        "GMO_API_KEY": "your-api-key",
        "GMO_SECRET_KEY": "your-secret-key",
        "ORDER_SIZE_LIMIT": "10000",
        "ORDER_SYMBOL_LIMITS": "USD_JPY,EUR_JPY",
        "ORDER_CLIENT_ORDER_ID_PREFIX": "mcp"
      }
    }
  }
}

只需要 GMO_API_KEY 和 GMO_SECRET_KEY。如果不需要订单大小、交易对或客户端订单 ID 限制，请删除可选环境变量。 --env 选项会将这些值从 MCP 客户端进程传递到 Docker 容器中。 对于 stdio，不要设置 MCP_TRANSPORT；服务默认使用 stdio。 由于 MCP 客户端通过标准输入/输出与容器通信，因此必须使用 -i 选项。

本地源代码检出

如果要从本地检出运行服务，而不是使用已发布的镜像，请使用此设置：

{
  "mcpServers": {
    "gmocoin-fx": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/gmocoin-fx-mcp",
        "run",
        "src/main.py"
      ],
      "env": {
        "GMO_API_KEY": "your-api-key",
        "GMO_SECRET_KEY": "your-secret-key",
        "ORDER_SIZE_LIMIT": "10000",
        "ORDER_SYMBOL_LIMITS": "USD_JPY,EUR_JPY",
        "ORDER_CLIENT_ORDER_ID_PREFIX": "mcp"
      }
    }
  }
}

HTTP

如果 MCP 客户端支持远程或基于 URL 的服务，请使用 HTTP。 启动服务：

docker run --rm \
  --env MCP_TRANSPORT=http \
  --env MCP_HTTP_HOST=0.0.0.0 \
  --env MCP_HTTP_PORT=8000 \
  --env MCP_HTTP_PATH=/mcp \
  --env GMO_API_KEY=your-api-key \
  --env GMO_SECRET_KEY=your-secret-key \
  -p 8000:8000 \
  ghcr.io/rikitonoto/gmocoin-fx-mcp:latest

然后在 MCP 客户端中注册服务 URL：

http://localhost:8000/mcp

环境变量

名称	必需	描述
GMO_API_KEY	是	GMO Coin FX API 密钥。
GMO_SECRET_KEY	是	GMO Coin FX 密钥。
ORDER_SIZE_LIMIT	否	order_api、close_order_api、ifd_order_api 和 ifdoco_order_api 工具接受的最大订单大小。
ORDER_SYMBOL_LIMITS	否	以逗号分隔的交易对列表，供 order_api、close_order_api、ifd_order_api、ifdoco_order_api 和 cancel_bulk_order_api 工具接受。
ORDER_CLIENT_ORDER_ID_PREFIX	否	用于自动生成 order_api、close_order_api、ifd_order_api 和 ifdoco_order_api 调用的 client_order_id，以及筛选 active_orders_api、latest_executions_api 和 open_positions_api 结果的 ASCII 字母数字前缀。长度不得超过 22 个字符。服务会追加 14 位时间戳后缀（yyyyMMddHHmmss），确保生成的 ID 不超过 GMO Coin FX 的 36 个字符限制。
MCP_TRANSPORT	否	要使用的 MCP 传输方式。默认为 stdio；设置为 http 可通过 HTTP 进行监听。也接受 sse 和 streamable-http。
MCP_HTTP_HOST	否	HTTP 传输方式使用的主机／接口。默认为 0.0.0.0。
MCP_HTTP_PORT	否	HTTP 传输方式使用的端口。默认为 8000。
MCP_HTTP_PATH	否	HTTP 传输方式的可选端点路径，例如 /mcp。

通过 HTTP 运行

默认情况下，服务仍使用标准的 stdio MCP 传输方式启动：

uv run src/main.py

要通过 HTTP 公开 MCP 服务，请在启动前设置 MCP_TRANSPORT=http：

MCP_TRANSPORT=http MCP_HTTP_HOST=0.0.0.0 MCP_HTTP_PORT=8000 uv run src/main.py

使用 Docker Compose 运行时，Compose 文件会加载 .env，但不会强制指定传输方式。将 MCP_TRANSPORT 留空以使用 stdio，或在 .env 中设置 MCP_TRANSPORT=http 以使用已发布的端口 8000。

工具

名称	描述
order_api	提交新的 GMO Coin FX 订单。
close_order_api	提交 GMO Coin FX 平仓订单。支持可选的 size 或 settle_position 参数。
ifd_order_api	使用 symbol、client_order_id、first_side、first_execution_type、first_size、first_price、second_execution_type、second_size 和 second_price 提交 GMO Coin FX IFD 订单。
ifdoco_order_api	使用 symbol、client_order_id、first_side、first_execution_type、first_size、first_price、second_size、second_limit_price 和 second_stop_price 提交 GMO Coin FX IFDOCO 订单。
change_ifdoco_order_api	修改现有 GMO Coin FX IFDOCO 订单的价格。指定 root_order_id 或 client_order_id（只能指定其中一个），并至少指定 first_price、second_limit_price 或 second_stop_price 中的一个。
change_ifd_order_api	修改现有 GMO Coin FX IFD 订单的价格。指定 root_order_id 或 client_order_id（只能指定其中一个），并至少指定 first_price 或 second_price 中的一个。
change_oco_order_api	修改现有 GMO Coin FX OCO 订单的限价／止损价。
change_order_api	修改 GMO Coin FX 普通订单的价格。指定 order_id 或 client_order_id（只能指定其中一个），并指定 price。
cancel_orders_api	一次最多取消 10 个 GMO Coin FX 订单。指定 root_order_ids 或 client_order_ids（只能指定其中一个）。
cancel_bulk_order_api	根据必填的 symbols 和可选的 side 与 settle_type 批量取消 GMO Coin FX 订单。配置 ORDER_SYMBOL_LIMITS 后，所有请求的交易对都必须在允许范围内。
active_orders_api	获取有效的 GMO Coin FX 订单。支持可选的 symbol、prev_id 和 count 参数。配置 ORDER_CLIENT_ORDER_ID_PREFIX 后，仅返回 client_order_id 以该前缀开头的有效订单。
latest_executions_api	获取指定必填 symbol 的最新 GMO Coin FX 成交记录，并支持可选的 count 参数。配置 ORDER_CLIENT_ORDER_ID_PREFIX 后，仅返回 client_order_id 以该前缀开头的成交记录。
open_positions_api	获取所有 GMO Coin FX 未平仓头寸。支持可选的 symbol 参数。配置 ORDER_CLIENT_ORDER_ID_PREFIX 后，会使用最新成交记录，仅返回开仓 client_order_id 以该前缀开头的头寸。

资源

URI	描述
gmocoin-fx://account/assets	以 JSON 格式获取 GMO Coin FX 账户资产余额。资产余额作为 MCP 资源提供，因为它是只读账户状态，具有稳定的 URI，且无需调用参数。