GMO Coin FX MCP Server

gmocoin-mcp

MCP クライアントの登録

stdio または HTTP を使用して、サーバーを MCP クライアントに登録します。 以下のローカルチェックアウトの例では /path/to/gmocoin-fx-mcp を使用しています。このパスを、このリポジトリの絶対パスに置き換えてください。

推奨：GHCR の Docker イメージ

推奨される設定では、公開されている GitHub Container Registry の Docker イメージを stdio 経由で実行します。 以下のエントリーを 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	いいえ	/mcp など、HTTP トランスポートの任意のエンドポイントパスです。

HTTP 経由での実行

サーバーは、デフォルトで標準の stdio MCP トランスポートを使用して起動します。

uv run src/main.py

MCP サーバーを HTTP 経由で公開するには、起動前に 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 を読み込みますが、トランスポートを強制的に指定することはありません。stdio を使用するには MCP_TRANSPORT を未設定のままにするか、公開ポート 8000 を使用するには .env で MCP_TRANSPORT=http を設定してください。

ツール

名前	説明
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 のうち少なくとも 1 つを指定してください。
change_ifd_order_api	既存の GMO Coin FX の IFD 注文の価格を変更します。root_order_id または client_order_id のいずれか一方を指定し、さらに first_price または second_price の少なくとも 1 つを指定してください。
change_oco_order_api	既存の GMO Coin FX の OCO 注文の指値価格／逆指値価格を変更します。
change_order_api	GMO Coin FX の通常注文の価格を変更します。order_id または client_order_id のいずれか一方と、price を指定してください。
cancel_orders_api	GMO Coin FX の注文を一度に最大 10 件まで取り消します。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 と、任意の count を指定して、GMO Coin FX の最新の約定を取得します。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	GMO Coin FX の口座資産残高を JSON 形式で取得します。資産残高は、読み取り専用の口座状態であり、安定した URI を持ち、呼び出しパラメーターを必要としないため、MCP リソースとして公開されます。