GeoFS MCP Server

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:

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:

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

• GeoFS - El simulador de vuelo basado en navegador
• Protocolo de contexto del modelo : especificación del protocolo para el contexto del modelo de IA