FIXSIM

fixsim-mcp

ホスト型 FIX プロトコルシミュレーターである FIXSIM 用の MCP サーバーです。 Claude、Cursor、VS Code、または ChatGPT に追加すれば、会話を通じて FIX をテストできます。

「FIX 4.4 のテストセッションを作成して、エンジンがログオンしたら知らせて、最初に送信した注文を表示してください。」

1 つのエンドポイントで 2 種類のツールを利用できます。

ツール	対象	認証
sandbox_*	すべてのユーザー	不要。Developer Sandbox で、無料・匿名の 4 時間セッションを利用できます
fixsim_*	FIXSIM のお客様	FIXSIM API キーを x-api-key ヘッダーで送信します

接続

ホスト型エンドポイント：https://mcp.fixsim.com/mcp（読み取り専用版：https://mcp.fixsim.com/mcp/readonly）。

Claude Code

claude mcp add --transport http fixsim https://mcp.fixsim.com/mcp --header "x-api-key: YOUR_FIXSIM_API_KEY"

無料のサンドボックスツールのみを使う場合は、--header を省略してください。

Cursor / VS Code（mcp.json）

{
  "mcpServers": {
    "fixsim": {
      "url": "https://mcp.fixsim.com/mcp",
      "headers": { "x-api-key": "YOUR_FIXSIM_API_KEY" }
    }
  }
}

Claude.ai / Claude Desktop：Customize → Connectors → Add custom connector → URL https://mcp.fixsim.com/mcp。 サンドボックスでは、認証に None を選択してください。独自のインスタンスを使う場合は、リクエストヘッダー x-api-key を追加します （コネクターのダイアログでヘッダーを設定する機能は順次展開中です。表示されない場合は、ひとまず Claude Code または Cursor を使ってください）。

ツール

サンドボックス（認証不要）

ツール	機能
sandbox_create_session	無料の FIX セッションを用意します。ホスト、ポート、SenderCompID（タグ 49）、TargetCompID（タグ 56）、BeginString、有効期限を返します。
sandbox_get_status	エンジンは接続されていますか？ connected / waiting / disabled
sandbox_get_messages	FIX メッセージのログを、未加工および解析済みの形式で取得します。新しいメッセージをポーリングするには afterSeq を指定します。
sandbox_get_orders	エンジンが送信した有効な注文を取得します。
sandbox_act_on_order	取引所として操作します：fill、partial、reject、cancel。
sandbox_set_autofill	受信したすべての注文を自動的に約定させます。
sandbox_get_session	接続情報カードを再取得します。
sandbox_end_session	セッションを早期に終了します。

サンドボックスの制限：1 セッションあたり 1 日 100 件のアプリケーションメッセージ、セッション時間は 4 時間、呼び出し元あたり数件のセッション。

FIXSIM インスタンス（API キー）

ツール	機能
fixsim_list_instances	キーでアクセスできるインスタンスを取得します。まずはこちらを使ってください。
fixsim_list_sessions, fixsim_get_session	インスタンス上のセッションを取得します：FIX バージョン、CompID、ロール、ログイン状態、シーケンス番号。
fixsim_list_orders_in, fixsim_get_order_in	システムが FIXSIM に送信した注文を、未加工の FIX と監査証跡とともに取得します。
fixsim_list_executions_out	FIXSIM が送信した約定レポート（確認応答、約定、拒否）を取得します。ClOrdID で絞り込めます。
fixsim_list_orders_out, fixsim_list_executions_in	FIXSIM が注文送信側の場合の逆方向のデータを取得します。
fixsim_list_securities	インスタンス上の銘柄と価格を取得します。
fixsim_act_on_orders	システムが送信した注文を確認応答、約定、部分約定、拒否、取消、期限切れにします。
fixsim_send_order	FIXSIM から New Order Single を送信します。
fixsim_cancel_order_out	FIXSIM が送信した注文を取り消します。
fixsim_send_raw_fix	セッションで任意の未加工 FIX メッセージを送信します。

/mcp/readonly エンドポイントでは同じツールを利用できますが、送信を伴うツールは拒否されます。

すべての fixsim_* 呼び出しは、キーでアクセスが許可されているインスタンスに対して検証され、キーごとにレート制限されます （デフォルトでは 1 分あたり 120 回）。

自分で実行する

.NET 8 が必要です。

dotnet run --project src/FixSim.Mcp --urls http://localhost:5199

設定（appsettings.json または FixSim__BaseUrl などの環境変数）：

キー	デフォルト	説明
FixSim:BaseUrl	https://portal.fixsim.com/	fixsim_* ツールが /v1 API を呼び出す FIXSIM サイト
FixSim:PerKeyCallsPerMinute	120	このサーバーでのキーごとのレート制限
Sandbox:Enabled	true	sandbox_* ツールを登録します
Sandbox:BaseUrl	https://sandbox.fixsim.com/	Developer Sandbox のウェブアプリ
Sandbox:CallerKey	empty	サンドボックスがサーバー間の呼び出しを信頼できるよう、X-Sandbox-Caller として送信される共有シークレット

このサーバーはステートレス（Streamable HTTP）なので、任意のロードバランサーの背後で水平スケーリングできます。

仕組み

このサーバーは薄いクライアントです。fixsim_* ツールはユーザーのキーを使って公開 FIXSIM REST API（/v1/...）を呼び出し、sandbox_* ツールは Developer Sandbox のセッション API を呼び出します。キーがアクセスできるインスタンスの情報を1分間キャッシュする以外、ここには何も保存されません。API キーは呼び出しごとに FIXSIM に転送され、ログに記録されることはありません。

ライセンス

MIT