GMO Coin FX MCP Server

io.github.RikitoNoto由 GitHub 账号 RikitoNoto 发布v1.0.1更新于 Nov 3, 2026

MCP server for GMO Coin FX trading, positions, executions, klines, and account balances.

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

让助手通过 GMO Coin API 在 GMO Coin FX 下单、改价、撤单，并查询持仓、成交记录与账户余额。

可以做什么
  • 在 GMO Coin FX 下新单、平仓单、IFD 单与 IFDOCO 单
  • 修改普通单、IFD 单、IFDOCO 单与 OCO 单的价格
  • 撤销单笔订单（一次最多 10 笔）或按品种批量撤单
  • 查询活动订单、最新成交与未平仓持仓，可按客户端订单 ID 前缀过滤
  • 以 JSON 资源形式读取账户资产余额
适用场景
适合需要让助手操作 GMO Coin FX 账户的场景，例如查看余额、持仓与成交，或在对话中起草并提交订单和改价。可选的订单数量、品种与客户端订单 ID 限制有助于把自动下单控制在预期范围内。
运行要求
以 stdio 方式在本机运行，通常使用已发布的 Docker 镜像（也可用 uv 从本地源码运行），另支持 HTTP 传输。需要 GMO Coin FX 的 API key 与 secret key，分别通过 GMO_API_KEY 和 GMO_SECRET_KEY 传入。可选的 ORDER_SIZE_LIMIT、ORDER_SYMBOL_LIMITS 与 ORDER_CLIENT_ORDER_ID_PREFIX 用于限制下单与过滤结果。需要能访问 GMO Coin API 的网络。
安装前请注意
服务器持有可下单、改单、撤单的交易凭证（GMO_API_KEY、GMO_SECRET_KEY），误操作或误解指令都可能造成真实资金损失。下单类工具会写入真实账户，建议设置 ORDER_SIZE_LIMIT 与 ORDER_SYMBOL_LIMITS 以限制风险敞口。可选的客户端订单 ID 前缀还会影响可见的订单、成交与持仓范围。以 HTTP 方式运行会把服务器暴露在网络接口上，应仅限本机或加以保护。

安装

在 SourceWeft 中

  1. 打开 控制台中的 GMO Coin FX MCP Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

gmocoin-mcp

MCP client registration

Register the server with an MCP client by using either stdio or HTTP. The local checkout example below uses /path/to/gmocoin-fx-mcp; replace it with the absolute path to this repository.

Recommended: Docker image from GHCR

The recommended setup is to run the published Docker image from GitHub Container Registry over stdio. Add the following entry to your MCP client configuration:

json
{  "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"      }    }  }}

Only GMO_API_KEY and GMO_SECRET_KEY are required. Remove optional environment variables when you do not need order-size, symbol, or client-order-id limits. The --env options pass those values from the MCP client process into the Docker container. Do not set MCP_TRANSPORT for stdio; the server uses stdio by default. The -i option is required because the MCP client communicates with the container over standard input/output.

Local source checkout

Use this setup when you want to run the server from a local checkout instead of the published image:

json
{  "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

Use HTTP when your MCP client supports remote or URL-based servers. Start the server:

bash
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

Then register the server URL in your MCP client:

text
http://localhost:8000/mcp

Environment variables

NameRequiredDescription
GMO_API_KEYYesGMO Coin FX API key.
GMO_SECRET_KEYYesGMO Coin FX secret key.
ORDER_SIZE_LIMITNoMaximum order size accepted by the order_api, close_order_api, ifd_order_api, and ifdoco_order_api tools.
ORDER_SYMBOL_LIMITSNoComma-separated list of symbols accepted by the order_api, close_order_api, ifd_order_api, ifdoco_order_api, and cancel_bulk_order_api tools.
ORDER_CLIENT_ORDER_ID_PREFIXNoASCII alphanumeric prefix used to auto-generate client_order_id for order_api, close_order_api, ifd_order_api, and ifdoco_order_api calls and to filter active_orders_api, latest_executions_api, and open_positions_api results. Must be 22 characters or fewer. The server appends a 14-digit timestamp suffix (yyyyMMddHHmmss) so the resulting ID stays within GMO Coin FX's 36-character limit.
MCP_TRANSPORTNoMCP transport to use. Defaults to stdio; set to http to listen over HTTP. sse and streamable-http are also accepted.
MCP_HTTP_HOSTNoHost/interface for HTTP transports. Defaults to 0.0.0.0.
MCP_HTTP_PORTNoPort for HTTP transports. Defaults to 8000.
MCP_HTTP_PATHNoOptional endpoint path for HTTP transports, such as /mcp.

Running over HTTP

The server still starts with the standard stdio MCP transport by default:

bash
uv run src/main.py

To expose the MCP server over HTTP, set MCP_TRANSPORT=http before starting it:

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

When running with Docker Compose, the compose file loads .env but does not force a transport. Leave MCP_TRANSPORT unset to use stdio, or set MCP_TRANSPORT=http in .env to use the published port 8000.

Tools

NameDescription
order_apiPlaces a new GMO Coin FX order.
close_order_apiPlaces a GMO Coin FX close order. Supports optional size or settle_position parameters.
ifd_order_apiPlaces a GMO Coin FX IFD order using symbol, client_order_id, first_side, first_execution_type, first_size, first_price, second_execution_type, second_size, and second_price.
ifdoco_order_apiPlaces a GMO Coin FX IFDOCO order using symbol, client_order_id, first_side, first_execution_type, first_size, first_price, second_size, second_limit_price, and second_stop_price.
change_ifdoco_order_apiChanges prices for an existing GMO Coin FX IFDOCO order. Specify exactly one of root_order_id or client_order_id, plus at least one of first_price, second_limit_price, or second_stop_price.
change_ifd_order_apiChanges prices for an existing GMO Coin FX IFD order. Specify exactly one of root_order_id or client_order_id, plus at least one of first_price or second_price.
change_oco_order_apiChanges limit/stop prices for an existing GMO Coin FX OCO order.
change_order_apiChanges the price of a GMO Coin FX normal order. Specify exactly one of order_id or client_order_id, plus price.
cancel_orders_apiCancels up to 10 GMO Coin FX orders at once. Specify exactly one of root_order_ids or client_order_ids.
cancel_bulk_order_apiCancels GMO Coin FX orders in bulk by required symbols and optional side and settle_type. When ORDER_SYMBOL_LIMITS is configured, every requested symbol must be allowed.
active_orders_apiRetrieves active GMO Coin FX orders. Supports optional symbol, prev_id, and count parameters. When ORDER_CLIENT_ORDER_ID_PREFIX is configured, only active orders whose client_order_id starts with that prefix are returned.
latest_executions_apiRetrieves the latest GMO Coin FX executions for a required symbol and optional count. When ORDER_CLIENT_ORDER_ID_PREFIX is configured, only executions whose client_order_id starts with that prefix are returned.
open_positions_apiRetrieves all GMO Coin FX open positions. Supports an optional symbol parameter. When ORDER_CLIENT_ORDER_ID_PREFIX is configured, latest executions are used to return only positions whose opening client_order_id starts with that prefix.

Resources

URIDescription
gmocoin-fx://account/assetsRetrieves GMO Coin FX account asset balances as JSON. Asset balances are exposed as an MCP resource because they are read-only account state with a stable URI and no invocation parameters.

来源：README.md，提交 362c0ad

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分