What is Geofs Mcp

geofs-mcp is a Model Context Protocol (MCP) server designed for the GeoFS flight simulator, enabling AI models to control and interact with aircraft in a browser-based environment.

Use cases

Use cases for geofs-mcp include AI-driven flight simulations, educational tools for aviation students, and automated testing of flight scenarios.

How to use

To use geofs-mcp, clone the repository, install dependencies, build the project, and start the server. Access the server via HTTP or WebSocket to control aircraft and retrieve flight data.

Key features

Key features include controlling aircraft flight parameters, accessing real-time flight data, navigating between waypoints and airports, selecting different aircraft models, and executing flight maneuvers like takeoff and landing.

Where to use

geofs-mcp can be used in aviation training, AI research, and simulation environments where flight dynamics and aircraft control are required.

GeoFS MCP Server

A Model Context Protocol (MCP) server for the GeoFS flight simulator, allowing AI models to control and interact with aircraft in the GeoFS browser-based flight simulator.

Features

• 🛫 Control aircraft flight parameters (throttle, heading, etc.)
• 📊 Access real-time flight data (position, speed, attitude)
• 🗺️ Navigate between waypoints and airports
• ✈️ Select different aircraft models
• 🔄 Execute flight maneuvers (takeoff, landing)

Prerequisites

• Node.js (v14 or higher)
• npm or yarn
• A modern web browser (Chrome recommended)

Installation

1. Clone this repository:

   git clone https://github.com/yourusername/geofs-mcp-server.git
   cd geofs-mcp-server
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Usage

Starting the Server

1. Start the MCP server:

   npm start
   

2. The server will launch a browser window that navigates to GeoFS

   • You may need to log in to GeoFS if required
   • The server will wait for GeoFS to fully load before accepting commands

3. The MCP server will be available at:

   • HTTP: http://localhost:3000
   • WebSocket: ws://localhost:3000

Using with AI Models

This MCP server can be used with AI models that support the Model Context Protocol, allowing them to:

1. Control aircraft in the simulator
2. Retrieve flight data and simulator state
3. Execute complex flight maneuvers
4. Plan and follow flight routes

API Endpoints

• GET /mcp - Get server capabilities and available endpoints
• GET /mcp/aircraft - Get current aircraft data
• POST /mcp/aircraft - Control aircraft parameters
• GET /mcp/flight-data - Get comprehensive flight data
• POST /mcp/navigation - Set navigation parameters
• GET /mcp/simulation - Get simulation status
• POST /mcp/simulation - Control simulation parameters

WebSocket Commands

The server also supports WebSocket for real-time communication:

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

Available commands:

• setThrottle - Set engine throttle (0-1)
• setHeading - Set target heading in degrees
• getPosition - Get current aircraft position
• selectAircraft - Change to a different aircraft
• takeOff - Execute takeoff procedure
• land - Execute landing procedure
• getFlightData - Get comprehensive flight data

Example Client

See the examples/simple-client.js file for a basic example of how to connect to and use the GeoFS MCP server.

To run the example:

node examples/simple-client.js

How It Works

The GeoFS MCP server uses Puppeteer to control a browser instance running GeoFS. It provides a standardized MCP interface that allows AI models to interact with the flight simulator through HTTP and WebSocket APIs.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

• GeoFS - The browser-based flight simulator
• Model Context Protocol - Protocol specification for AI model context