GeoFS MCP Server

Integrations

  • Enables control and interaction with aircraft in the GeoFS browser-based flight simulator, allowing for setting flight parameters, retrieving real-time flight data, navigating between waypoints, and executing flight maneuvers through JavaScript APIs.

  • Powers the MCP server that bridges AI models with the GeoFS flight simulator, providing HTTP and WebSocket endpoints for aircraft control, flight data retrieval, and simulation management.

  • Used to programmatically control a browser instance running the GeoFS flight simulator, enabling automated interaction with the simulation environment.

Servidor MCP de GeoFS

Un servidor de Protocolo de Contexto de Modelo (MCP) para el simulador de vuelo GeoFS, que permite que los modelos de IA controlen e interactúen con aeronaves en el simulador de vuelo basado en navegador GeoFS.

Características

  • 🛫 Controlar los parámetros de vuelo de la aeronave (acelerador, rumbo, etc.)
  • 📊 Accede a datos de vuelo en tiempo real (posición, velocidad, actitud)
  • 🗺️ Navegar entre puntos de referencia y aeropuertos
  • ✈️ Selecciona diferentes modelos de aeronaves
  • 🔄 Ejecutar maniobras de vuelo (despegue, aterrizaje)

Prerrequisitos

  • Node.js (v14 o superior)
  • npm o hilo
  • Un navegador web moderno (se recomienda Chrome)

Instalación

  1. Clonar este repositorio:
    git clone https://github.com/yourusername/geofs-mcp-server.git cd geofs-mcp-server
  2. Instalar dependencias:
    npm install
  3. Construir el proyecto:
    npm run build

Uso

Iniciando el servidor

  1. Inicie el servidor MCP:
    npm start
  2. El servidor abrirá una ventana del navegador que navegará a GeoFS
    • Es posible que necesite iniciar sesión en GeoFS si es necesario
    • El servidor esperará a que GeoFS se cargue completamente antes de aceptar comandos.
  3. El servidor MCP estará disponible en:
    • HTTP: http://localhost:3000
    • WebSocket: ws://localhost:3000

Uso de modelos de IA

Este servidor MCP se puede utilizar con modelos de IA que admiten el Protocolo de contexto de modelo, lo que les permite:

  1. Controlar la aeronave en el simulador
  2. Recuperar datos de vuelo y el estado del simulador
  3. Ejecutar maniobras de vuelo complejas
  4. Planificar y seguir rutas de vuelo

Puntos finales de API

  • GET /mcp : obtiene las capacidades del servidor y los puntos finales disponibles
  • GET /mcp/aircraft - Obtener datos actuales de la aeronave
  • POST /mcp/aircraft - Controlar los parámetros de la aeronave
  • GET /mcp/flight-data - Obtenga datos de vuelo completos
  • POST /mcp/navigation - Establecer parámetros de navegación
  • GET /mcp/simulation - Obtener el estado de la simulación
  • POST /mcp/simulation - Parámetros de simulación de control

Comandos de WebSocket

El servidor también admite WebSocket para la comunicación en tiempo real:

// Example WebSocket message { "id": 1, "type": "command", "command": "setThrottle", "params": { "value": 0.75 } }

Comandos disponibles:

  • setThrottle - Establece el acelerador del motor (0-1)
  • setHeading - Establece el rumbo del objetivo en grados
  • getPosition - Obtener la posición actual de la aeronave
  • selectAircraft - Cambiar a una aeronave diferente
  • takeOff - Ejecutar procedimiento de despegue
  • land - Ejecutar procedimiento de aterrizaje
  • getFlightData - Obtenga datos completos de vuelos

Cliente de ejemplo

Consulte el archivo examples/simple-client.js para obtener un ejemplo básico de cómo conectarse y utilizar el servidor GeoFS MCP.

Para ejecutar el ejemplo:

node examples/simple-client.js

Cómo funciona

El servidor MCP de GeoFS utiliza Puppeteer para controlar una instancia de navegador que ejecuta GeoFS. Proporciona una interfaz MCP estandarizada que permite que los modelos de IA interactúen con el simulador de vuelo mediante las API HTTP y WebSocket.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

-
security - not tested
F
license - not found
-
quality - not tested

Un servidor que permite que los modelos de IA controlen e interactúen con aeronaves en el simulador de vuelo basado en navegador GeoFS a través de interfaces estandarizadas.

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Starting the Server
          2. Using with AI Models
          3. API Endpoints
          4. WebSocket Commands
        2. Example Client
          1. How It Works
            1. Contributing
              1. License
                1. Acknowledgements
                  ID: vhg9ud9l0a