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 分