Servidor MCP de Interactive Brokers

AVISO LEGAL: Este es un servidor MCP no oficial, desarrollado por la comunidad, y NO está afiliado ni respaldado por Interactive Brokers. Este software se encuentra en estado Alpha y puede no funcionar perfectamente.

Un servidor del Protocolo de Contexto de Modelo (MCP) que proporciona integración con la plataforma de trading de Interactive Brokers. Este servidor permite a los asistentes de IA interactuar con su cuenta de IB para obtener datos de mercado, consultar posiciones y realizar operaciones.

🔒 Aviso de seguridad

Related MCP server: Interactive Brokers MCP Server

Características

• Integración con la API de Interactive Brokers: Capacidades completas de trading, incluyendo gestión de cuentas, seguimiento de posiciones, datos de mercado en tiempo real y gestión de órdenes (órdenes de mercado, límite y stop).

• Soporte para Flex Query: Ejecute Flex Queries para obtener estados de cuenta, confirmaciones de operaciones y datos históricos. Las consultas se recuerdan automáticamente para facilitar su reutilización.

• Autenticación flexible: Elija entre autenticación OAuth basada en navegador o modo headless con credenciales para entornos automatizados.

• Configuración sencilla: Ejecútelo directamente con npx: no requiere Docker ni instalaciones adicionales. Incluye IB Gateway preconfigurado y entorno de ejecución Java para todas las plataformas.

Aviso de seguridad

ADVERTENCIAS IMPORTANTES:

• Riesgo financiero: El trading implica un riesgo sustancial de pérdida. Pruebe siempre primero con una cuenta de trading simulado (paper trading).

• Seguridad: Este software maneja datos financieros sensibles. Ejecútelo solo localmente, nunca en servidores públicos.

• Sin garantía: Este software no oficial se entrega sin garantías. Úselo bajo su propia responsabilidad.

• No es asesoramiento financiero: Esta herramienta es solo para automatización, no constituye asesoramiento financiero.

Requisitos previos

¡No se requieren instalaciones adicionales! Este paquete incluye:

• IB Gateway preconfigurado para todas las plataformas (Linux, macOS, Windows)

• Java Runtime Environment (JRE) para IB Gateway, incluyendo una compilación musl-libc para contenedores basados en Alpine (ej. node:lts-alpine, supergateway)

• Todas las dependencias necesarias

Solo necesita:

• Una cuenta de Interactive Brokers (trading simulado o real)

• Node.js 18+ (para ejecutar el servidor MCP)

Inicio rápido

Añada este servidor MCP a su configuración de Cursor/Claude:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"]
    }
  }
}

Cuando utilice el servidor por primera vez, se abrirá automáticamente una ventana del navegador para el flujo de autenticación OAuth de Interactive Brokers. Inicie sesión con sus credenciales de IB para autorizar la conexión.

Configuración del modo Headless

Para entornos automatizados o cuando prefiera no utilizar un navegador para la autenticación, puede habilitar el modo headless configurándolo en la configuración de su servidor MCP:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_HEADLESS_MODE": "true",
        "IB_USERNAME": "your_ib_username",
        "IB_PASSWORD_AUTH": "your_ib_password"
      }
    }
  }
}

En el modo headless, el servidor se autenticará automáticamente utilizando sus credenciales sin abrir una ventana del navegador. Esto es útil para:

• Sistemas de trading automatizados

• Entornos de servidor sin pantalla

• Pipelines de CI/CD

• Situaciones donde no se desea la interacción con el navegador

Importante: Incluso en modo headless, Interactive Brokers puede requerir autenticación de dos factores (2FA). Cuando se active la 2FA, la autenticación headless esperará a que usted complete el proceso de 2FA a través de su método configurado (aplicación móvil, SMS, etc.) antes de continuar.

Para habilitar el trading simulado (paper trading), añada "IB_PAPER_TRADING": "true" a sus variables de entorno:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_HEADLESS_MODE": "true",
        "IB_USERNAME": "your_ib_username",
        "IB_PASSWORD_AUTH": "your_ib_password",
        "IB_PAPER_TRADING": "true"
      }
    }
  }
}

Nota de seguridad: Almacene las credenciales de forma segura y nunca las suba al control de versiones. Considere utilizar archivos de variables de entorno o sistemas seguros de gestión de credenciales.

Configuración de Flex Query (Opcional)

Para utilizar Flex Queries para obtener estados de cuenta y datos históricos, necesita configurar su Token de Flex Web Service:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_FLEX_TOKEN": "your_flex_token_here"
      }
    }
  }
}

Cómo obtener su Token Flex:

1. Inicie sesión en Interactive Brokers Account Management

2. Vaya a Settings → Account Settings

3. Navegue a Reporting → Flex Web Service

4. Genere u obtenga su Token de Flex Web Service

Para obtener instrucciones detalladas sobre cómo habilitar el Flex Web Service, consulte la Guía de IB Flex Web Service.

Creación de Flex Queries:

1. Vaya a Reports → Flex Queries en Account Management

2. Cree o personalice su plantilla de consulta

3. Haga clic en el icono de información junto a su consulta para encontrar su ID de consulta (Query ID)

Para obtener una guía completa sobre cómo crear y personalizar Flex Queries, consulte la Guía de IB Flex Queries.

Nota: Cuando ejecuta una Flex Query por primera vez, el servidor MCP la guarda automáticamente con su nombre desde la API. Las ejecuciones futuras pueden hacer referencia a la consulta por su ID o por su nombre guardado.

Características de Flex Query:

• Memoria automática: Cuando ejecuta una Flex Query, se guarda automáticamente para su uso futuro.

• Reutilización sencilla: Las consultas utilizadas anteriormente se recuerdan; no es necesario copiar los IDs de consulta repetidamente.

• Nombres amigables: Opcionalmente, proporcione un nombre amigable al ejecutar una consulta por primera vez.

• Olvidar consultas: Elimine las consultas que ya no necesite con la herramienta forget_flex_query.

Variables de configuración

Herramientas MCP disponibles

Trading y gestión de cuentas

Flex Queries (Requiere IB_FLEX_TOKEN)

Solución de problemas

Problemas de autenticación:

• Utilice la interfaz web que se abre automáticamente.

• Complete cualquier autenticación de dos factores requerida.

• Pruebe el modo de trading simulado si el trading real falla.

Soporte

• Este servidor: Abra un issue en este repositorio.

Licencia

Licencia MIT - consulte el archivo LICENSE para más detalles.

Gracias a nuestros colaboradores

Muchas gracias a todos los que han contribuido a mejorar este proyecto.