Servidor MCP de SimBrief

Un servidor de Model Context Protocol que brinda a Claude Desktop acceso directo a tus planes de vuelo de SimBrief: sin Cloudflare, sin OAuth, sin necesidad de infraestructura.

Servidor MCP SimBrief-MCPServer

Características

14 herramientas que cubren cada sección de un OFP de SimBrief:

Herramienta	Descripción
`get_flight_summary`	Número de vuelo, aeronave, ruta, distancia, crucero, ETE, combustible
`get_weather`	METAR, TAF y ATIS para salida, llegada y alternativo
`get_fuel_plan`	Desglose completo de combustible: rodaje, trayecto, contingencia, alternativo, reserva, extra
`get_weights`	OEW, carga útil, ZFW, TOW, peso en rampa, peso de aterrizaje
`get_times`	OUT/OFF/ON/IN programados, ETE, tiempo de bloque, rodaje, autonomía
`get_atc_flightplan`	Cadena de plan de vuelo ATC lista para presentar
`get_aircraft_info`	Tipo, matrícula, motores, códigos de equipo
`get_navlog`	Lista completa de waypoints con altitud, distancia y combustible por tramo
`get_notams`	Todos los NOTAMs (salida, llegada, en ruta)
`get_alternate_info`	Detalles del aeropuerto alternativo y registro de navegación
`get_performance`	Rendimiento de despegue y aterrizaje (TLR), si está disponible
`get_crew`	Capitán, primer oficial, despachador, sobrecargo, auxiliares de vuelo
`get_impacts`	Sensibilidad de combustible y tiempo a cambios de altitud e índice de costo
`get_full_flight_plan`	JSON completo sin procesar para análisis personalizado

Todas las herramientas aceptan un parámetro opcional plan_id: déjalo vacío para obtener siempre tu último despacho.

Related MCP server: SimBrief Flight Planning MCP Server

Requisitos

Python 3.11+
uv
Una cuenta de SimBrief (gratuita)

Instalación

git clone https://github.com/Emanuele94/SimBrief-MCPServer.git
cd SimBrief-MCPServer
uv sync

Configuración

Tu Pilot ID de SimBrief se pasa a través de una variable de entorno en la configuración de MCP; no se requieren cambios en el código.

Encuentra tu Pilot ID en SimBrief → Account Settings → Pilot ID.

Integración con Claude Desktop

Añade lo siguiente a tu claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "simbrief": {
      "command": "uv",
      "args": [
        "run",
        "--project", "/absolute/path/to/SimBrief-MCPServer",
        "python",
        "/absolute/path/to/SimBrief-MCPServer/server.py"
      ],
      "env": {
        "SIMBRIEF_PILOT_ID": "your_pilot_id_here"
      }
    }
  }
}

Luego reinicia Claude Desktop. Las herramientas de SimBrief aparecerán automáticamente.

El servidor se negará a iniciarse con un mensaje de error claro si SIMBRIEF_PILOT_ID no está configurado.

Ejemplos de uso

Una vez conectado, puedes preguntar a Claude cosas como:

"¿Cuál es mi último plan de vuelo?"
"Muéstrame el clima para mi próximo vuelo."
"¿Cuánto combustible tengo planificado y cuál es el desglose?"
"Dame la cadena completa del plan de vuelo ATC."
"¿Qué sucede con el consumo de combustible si vuelo 2000 pies más bajo?"
"Muéstrame los primeros 20 waypoints de mi registro de navegación."

Desarrollo

Instala las dependencias de desarrollo:

uv sync --all-extras

Ejecuta las pruebas:

uv run pytest -v

Lint y formato:

uv run ruff check .
uv run ruff format .

Todas las pruebas se ejecutan completamente sin conexión: la API de SimBrief está simulada, por lo que no se requiere conexión a Internet ni un Pilot ID real.

Contribución

Haz un fork del repositorio
Crea una rama de características (git checkout -b feature/my-feature)
Realiza tus cambios y añade pruebas
Asegúrate de que la canalización de CI pase localmente (uv run pytest && uv run ruff check .)
Abre una Pull Request contra main

Las PR deben pasar todas las comprobaciones (pruebas + lint) antes de que puedan ser fusionadas.

Licencia

MIT

SimBrief MCP Server