MCP Options Order Flow Server

Un servidor MCP de alto rendimiento para el análisis completo del flujo de

Documentación

MCP Options Order Flow Server

Un servidor de Protocolo de Contexto de Modelo (MCP) de alto rendimiento para un análisis integral del flujo de órdenes de opciones. Este servidor proporciona datos de flujo de órdenes de opciones en tiempo real, detección de patrones y análisis de sesgo institucional a través de una interfaz MCP intuitiva.

🚀 Características

Análisis de flujo de opciones en tiempo real: Monitoree el flujo de órdenes de opciones en múltiples contratos con tiempos de respuesta inferiores a 10 ms
Detección avanzada de patrones: Identifique barridos, bloques y patrones de volumen inusuales con algoritmos de grado institucional
Seguimiento de sesgo institucional: Monitoree el posicionamiento del dinero inteligente y el sentimiento direccional
Análisis de tendencias históricas: Análisis de intervalos de 30 minutos con cambios direccionales clave
Monitoreo dinámico: Configure y monitoree rangos de precios de ejercicio y vencimientos específicos sin reinicios
Alto rendimiento: Construido para uso en producción con arquitectura distribuida Go+Python

🏗️ Arquitectura

Este servidor MCP se integra con el servicio Go mcp-trading-data-broker para proporcionar:

┌─────────────────────┐    gRPC     ┌─────────────────────┐    WebSocket    ┌─────────────────────┐
│ MCP Options Server  │ ──────────► │ mcp-trading-data-   │ ──────────────► │ Market Data         │
│ (Python)            │             │ broker (Go)         │                 │ Provider            │
│                     │             │                     │                 │                     │
│ • MCP Tools         │             │ • Options Analysis  │                 │ • Options Quotes    │
│ • XML Formatting    │             │ • Pattern Detection │                 │ • Real-time Data    │
│ • Context Building  │             │ • Data Storage      │                 │                     │
└─────────────────────┘             └─────────────────────┘                 └─────────────────────┘

📋 Requisitos previos

mcp-trading-data-broker: El servicio de intermediario de datos basado en Go
- Proporciona servidor gRPC en el puerto 9090
- Maneja la recopilación y análisis de datos de opciones en tiempo real
- Debe estar ejecutándose antes de iniciar este servidor MCP
Python 3.8+: Requerido para el servidor MCP
Acceso a red: Para la comunicación gRPC entre servicios

⚡ Inicio rápido

1. Instalación

# Clone the repository
git clone <repository-url>
cd mcp-options-order-flow-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On macOS/Linux
# venv\Scripts\activate     # On Windows

# Install dependencies
pip install -r requirements.txt

2. Configuración

Establezca las variables de entorno:

# gRPC Data Broker Connection
export GRPC_HOST=localhost
export GRPC_PORT=9090
export GRPC_TIMEOUT=30

# Optional: Custom logging
export LOG_LEVEL=INFO

3. Iniciar el servidor

# Method 1: Using the convenience script
python run_server.py

# Method 2: Using module execution 
python -m src.mcp_server

# Method 3: Direct execution
python src/mcp_server.py

4. Integración con Claude Desktop

Agregue a su configuración MCP de Claude Desktop:

{
  "mcpServers": {
    "options-flow": {
      "command": "python",
      "args": ["run_server.py"],
      "cwd": "/path/to/mcp-options-order-flow-server",
      "env": {
        "GRPC_HOST": "localhost",
        "GRPC_PORT": "9090"
      }
    }
  }
}

🛠️ Herramientas MCP disponibles

1. `analyze_options_flow`

Obtenga un análisis integral del flujo de órdenes de opciones para un ticker.

Parámetros:

ticker (string): Símbolo de ticker de acciones (por ejemplo, "SPY", "QQQ")

Devuelve: Análisis con formato XML que incluye:

Contratos monitoreados agrupados por vencimiento y precio de ejercicio
Niveles de actividad actuales y sesgo direccional
Patrones detectados con puntuaciones de confianza
Análisis de tendencias históricas con intervalos de 30 minutos
Sesgo institucional y precios de ejercicio más activos

2. `configure_options_monitoring_tool`

Configure el monitoreo de opciones para contratos específicos.

Parámetros:

ticker (string): Símbolo de ticker de acciones
configurations (array): Objetos de configuración con:
- expiration (integer): Fecha de vencimiento en formato YYYYMMDD
- strike_range (array): Lista de precios de ejercicio a monitorear
- include_both_types (boolean): Monitorear tanto calls como puts

Ejemplo:

{
  "ticker": "SPY",
  "configurations": [
    {
      "expiration": 20240419,
      "strike_range": [400, 405, 410],
      "include_both_types": true
    }
  ]
}

3. `get_monitoring_status_tool`

Obtenga el estado actual de la configuración de monitoreo.

Parámetros:

ticker (string): Símbolo de ticker de acciones

Devuelve: Estado con formato XML que muestra todos los contratos monitoreados activamente

4. `data_broker_health_check`

Verifique la conectividad y el estado de salud del intermediario de datos.

Devuelve: Estado de salud con detalles de conexión y métricas de tiempo de respuesta

💡 Uso de ejemplo

1. Configurar monitoreo

"Please monitor SPY options for expiration 2024-04-19, strikes 400-410, both calls and puts"

2. Analizar flujo de opciones

"Analyze the current options flow for SPY"

3. Verificar estado del monitoreo

"What options contracts are currently being monitored for SPY?"

los sitios están configurados correctamente

MCP Options Order Flow Server

Documentación