FIX-MCP

Los agentes de IA pueden escribir mensajes FIX. No pueden recuperar una sesión bloqueada, validar un NewOrderSingle o pausar un TWAP que lleva retraso. FIX-MCP les proporciona el cerebro de operaciones de trading para hacer las tres cosas mediante herramientas MCP explícitas, puertas de aprobación y evidencia auditable.

FIX-MCP es una demostración profesional de código abierto para operaciones de trading asistidas por IA. Proporciona a Claude, GPT, Gemini y a cualquier agente compatible con MCP una superficie de herramientas controlada para diagnosticar y resolver incidentes realistas de FIX, OMS, datos de referencia, centros de negociación y algoritmos, mientras un operador humano sigue siendo responsable de la aprobación y el control final.

La demostración se ejecuta en un entorno de broker-dealer simulado. La tesis del producto es más amplia: MCP es la interfaz adecuada para permitir que los LLM trabajen con sistemas operativos reales sin darles acceso mágico e ilimitado a la mesa de operaciones.

Qué incluye

• 22 herramientas MCP para reparación de sesiones, triaje de órdenes, actualizaciones de datos de referencia, estado de centros de negociación, gestión de algoritmos, puntuación de escenarios y captura de trazas.

• 14 escenarios reales de mesa de operaciones que cubren desde el inicio previo al amanecer a las 02:05 ET hasta fallos en dark pools fuera de horario a las 16:32 ET.

• Flujo de trabajo dirigido por humanos: investigar, aprobar libro de trabajo, ejecutar recuperación aprobada y luego realizar pruebas de estrés solo después de entender la ruta base.

• Panel de control de Misión: con resumen del caso, libro de trabajo, carril del operador, traza, cable FIX, terminal, manual de procedimientos y panel de copiloto.

• Stack con formato de producción: servidor MCP en Python, API REST, consola Next.js, PostgreSQL 16, Redis 7, Docker Compose y andamiaje de conector TCP FIX asíncrono.

Modelo de control de IA

• System prompt: src/fix_mcp/prompts/trading_ops.py se expone a los clientes MCP como fix://prompts/trading-ops. La consola web lo refleja en src/store/prompts.ts.

• Configuración del modelo: el copiloto de Misión Control llama actualmente a openai/gpt-5.4 a través de OpenRouter, ya sea mediante una OPENROUTER_API_KEY del lado del servidor o una clave proporcionada por el usuario en el panel del Copiloto.

• Marco de trabajo del agente: este repositorio no utiliza LangChain ni LangGraph. El límite de control son las herramientas MCP, los recursos MCP, los prompts MCP, FastAPI y la consola de operador de Next.js.

• Controles de alucinación: los hechos de los escenarios provienen de fixtures JSON y del estado del motor en vivo; las acciones pasan por herramientas MCP tipadas; los pasos similares a producción requieren aprobación humana; cada llamada a herramienta es visible en la traza.

• Límite de la demostración: el entorno incluido está simulado. No conecte una demostración pública a sistemas reales de FIX, OMS, datos de referencia o monitorización.

Consulte System Prompt, Model, and Guardrails para obtener la respuesta orientada a la demostración sobre el modelo, el prompt, LangChain/LangGraph y las preguntas de fundamentación.

Para quién es esto

Recorrido destacado — Inicio de BATS a las 02:05 ET

La mesa de operaciones carga bats_startup_0200.

Incidente: El inicio de sesión en BATS es rechazado porque la contraparte espera la secuencia 2450, mientras que la sesión se restableció a 1. Ocho órdenes GTC nocturnas están bloqueadas, faltan dos símbolos ETF en los datos de referencia de horario extendido e IEX está saludable como alternativa.

El operador pide al copiloto que investigue. El agente utiliza herramientas MCP:

list_scenarios       Scenario Loaded: bats_startup_0200
check_fix_sessions   BATS down; sequence mismatch detected
query_orders         ORDER QUERY — 14 order(s) found

El agente propone un libro de trabajo de recuperación:

1. Check BATS session
2. Quantify blocked flow
3. Reconnect BATS
4. Reset BATS sequence if needed
5. Load missing ETF symbols
6. Validate orders released

El humano aprueba el libro de trabajo. La ejecución del agente realiza solo la ruta aprobada:

fix_session_issue    BATS reconnect released stuck orders
fix_session_issue    BATS reset_sequence accepted
load_ticker          BITO loaded
load_ticker          GBTC loaded
validate_orders      14 PASS, 0 FAIL

Entonces, y solo entonces, el operador utiliza el Laboratorio de Estrés para inyectar un evento de brecha de secuencia y probar que el sistema se pausa, vuelve a realizar el triaje, se recupera, se reanuda y registra la traza.

Ese es el patrón operativo: primero la línea base, segundo la prueba de presión, siempre la evidencia.

Inicio rápido

git clone https://github.com/henryurlo/fix-mcp.git
cd fix-mcp
docker compose up -d

Abra http://localhost:3000.

Inicie sesión con henry / henry, admin / admin, o haga clic en Demo Mode.

No se requiere Node ni Python en su host para la demostración de Docker.

Desarrollo en Python

python -m pip install -e ".[dev]"
python -m fix_mcp.api

En otra terminal:

npm install
npm run dev

La consola de Next.js lee BACKEND_URL, que por defecto es http://127.0.0.1:8000.

Configuración del cliente MCP

Para un cliente MCP local que pueda iniciar el punto de entrada de Python:

{
  "mcpServers": {
    "fix-mcp": {
      "command": "fix-mcp"
    }
  }
}

Para un cliente/proxy MCP compatible con HTTP:

{
  "mcpServers": {
    "fix-mcp": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote@latest"],
      "env": {
        "MCP_URL": "http://localhost:8000/mcp"
      }
    }
  }
}

Demostración vs Producción

El trabajo profesional es la capa de integración: conectar la misma interfaz MCP y el conocimiento de operaciones de trading en los registros reales, OMS, datos de referencia, monitorización y flujo de trabajo de aprobación de una empresa.

Documentación

• System prompt, model, and guardrails

• Scenario catalog

• Architecture

• Production integration notes

• Operator demo flow

• Remotion demo scripts

Contacto

henryurlo@gmail.com

Licencia

MIT. Consulte LICENSE.