FIXSIM

fixsim-mcp

一个适用于 FIXSIM（托管式 FIX 协议模拟器）的 MCP 服务。 将它添加到 Claude、Cursor、VS Code 或 ChatGPT，即可通过对话测试 FIX：

“为我创建一个 FIX 4.4 测试会话，然后在我的引擎登录后告诉我，并展示它发送的第一笔订单。”

两组工具共用一个端点：

工具	使用者	身份验证
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：自定义 → 连接器 → 添加自定义连接器 → URL https://mcp.fixsim.com/mcp。 为沙盒选择身份验证方式 None。若要使用你自己的实例，请添加请求标头 x-api-key （连接器对话框中的标头支持正在逐步推出；如果你还看不到此选项，目前请使用 Claude Code 或 Cursor）。

工具

沙盒（无需身份验证）

工具	功能
sandbox_create_session	创建免费的 FIX 会话。返回主机、端口、SenderCompID（你的 tag 49）、TargetCompID（tag 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	提前结束会话。

沙盒限制：每个会话每天最多 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_* 调用都会根据你的密钥有权访问的实例进行验证，并受每个密钥的速率限制 （默认每分钟 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 Web 应用
Sandbox:CallerKey	empty	作为 X-Sandbox-Caller 发送的共享密钥，以便沙盒信任服务间调用

该服务为无状态服务（Streamable HTTP），可在任何负载均衡器后水平扩展。

工作原理

该服务是一个轻量级客户端。fixsim_* 工具使用你的密钥调用公开的 FIXSIM REST API（/v1/...）；sandbox_* 工具调用 Developer Sandbox 的会话 API。除缓存一分钟的密钥可访问实例信息外，此处不会存储任何内容。每次调用时，你的 API 密钥都会转发给 FIXSIM，且绝不会记录到日志中。

许可证

MIT