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)

Related MCP server: Playwright MCP Server

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