MCP Options Order Flow Server

Servidor MCP Options Order Flow

Um servidor de alto desempenho do Model Context Protocol (MCP) para análise abrangente do fluxo de ordens de opções. Este servidor fornece dados de fluxo de ordens de opções em tempo real, detecção de padrões e análise de viés institucional por meio de uma interface MCP intuitiva.

🚀 Recursos

• Análise de Fluxo de Opções em Tempo Real: Monitore o fluxo de ordens de opções em múltiplos contratos com tempos de resposta abaixo de 10ms
• Detecção Avançada de Padrões: Identifique sweeps, blocks e padrões de volume incomum com algoritmos de nível institucional
• Rastreamento de Viés Institucional: Monitore o posicionamento de smart money e o sentimento direcional
• Análise de Tendências Históricas: Análise em intervalos de 30 minutos com mudanças direcionais-chave
• Monitoramento Dinâmico: Configure e monitore faixas de preço de exercício e expirações específicas sem reinicializações
• Alto Desempenho: Construído para uso em produção com arquitetura distribuída em Go+Python

🏗️ Arquitetura

Este servidor MCP integra-se ao serviço Go mcp-trading-data-broker para fornecer:

┌─────────────────────┐    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      │                 │                     │
└─────────────────────┘             └─────────────────────┘                 └─────────────────────┘

📋 Pré-requisitos

1. mcp-trading-data-broker: O serviço de broker de dados baseado em Go

   • Fornece servidor gRPC na porta 9090
   • Lida com coleta e análise de dados de opções em tempo real
   • Deve estar em execução antes de iniciar este servidor MCP

2. Python 3.8+: Necessário para o servidor MCP

3. Acesso à Rede: Para comunicação gRPC entre serviços

⚡ Início Rápido

1. Instalação

# 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. Configuração

Defina as variáveis de ambiente:

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

# Optional: Custom logging
export LOG_LEVEL=INFO

3. Inicie o 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. Integração com Claude Desktop

Adicione à configuração MCP do seu 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"
      }
    }
  }
}

🛠️ Ferramentas MCP Disponíveis

1. analyze_options_flow

Obtenha análise abrangente do fluxo de ordens de opções para um ticker.

Parâmetros:

• ticker (string): Símbolo do ticker da ação (ex.: "SPY", "QQQ")

Retorna: Análise formatada em XML incluindo:

• Contratos monitorados agrupados por expiração e preço de exercício
• Níveis de atividade atuais e viés direcional
• Padrões detectados com pontuações de confiança
• Análise de tendências históricas com intervalos de 30 minutos
• Viés institucional e preços de exercício mais ativos

2. configure_options_monitoring_tool

Configure o monitoramento de opções para contratos específicos.

Parâmetros:

• ticker (string): Símbolo do ticker da ação
• configurations (array): Objetos de configuração com:
  • expiration (inteiro): Data de expiração no formato YYYYMMDD
  • strike_range (array): Lista de preços de exercício para monitorar
  • include_both_types (booleano): Monitorar calls e puts

Exemplo:

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

3. get_monitoring_status_tool

Obtenha o status atual da configuração de monitoramento.

Parâmetros:

• ticker (string): Símbolo do ticker da ação

Retorna: Status formatado em XML mostrando todos os contratos monitorados ativamente

4. data_broker_health_check

Verifique a conectividade e o status de saúde do broker de dados.

Retorna: Status de saúde com detalhes de conexão e métricas de tempo de resposta

💡 Exemplo de Uso

1. Configure o Monitoramento

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

2. Analise o Fluxo de Opções

"Analyze the current options flow for SPY"

3. Verifique o Status do Monitoramento

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

os sites estão configurados corretamente