GeoFS

You can run a GeoFS MCP Server to let AI models control and monitor aircraft inside the GeoFS browser-based flight simulator. It exposes HTTP and WebSocket interfaces to set flight parameters, retrieve real-time flight data, navigate routes, switch aircraft models, and perform maneuvers like takeoff and landing. This enables automated agents to interact with the simulator in a structured, programmatic way.

How to use

Start the MCP server to establish the HTTP and WebSocket interfaces you will use from your MCP client. Use the HTTP endpoints to query server capabilities, current aircraft data, flight data, and to send navigation or simulation commands. Use the WebSocket channel for real-time command streaming and rapid control of throttle, heading, and other flight controls.

How to install

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

# 1. Install dependencies (from project root)
- npm install

# 2. Build the project
- npm run build

# 3. Start the MCP server
- npm start

Additional sections

Configuration and usage details are designed to be direct and practical. You will run the server, connect via HTTP to obtain data and issue control commands, and optionally connect over WebSocket for real-time interaction.

Key endpoints and capabilities you will typically use include obtaining server capabilities, querying current aircraft data, retrieving flight data, setting navigation, and controlling the simulation status. Real-time control commands allow you to set throttle, heading, and other flight parameters, select different aircraft models, and execute takeoff or landing procedures.

Server connection details

After starting, the MCP server is available at the following endpoints. You can interact with these from your MCP client to control and monitor the GeoFS simulator.

HTTP endpoint: http://localhost:3000

WebSocket endpoint: ws://localhost:3000

Available tools

setThrottle

Adjusts the engine throttle to a value between 0 and 1, enabling precise speed control.

setHeading

Sets the target heading in degrees for the aircraft's flight path.

getPosition

Retrieves the current latitude, longitude, altitude, and orientation of the aircraft.

selectAircraft

Switches to a different aircraft model available in GeoFS.

takeOff

Initiates the takeoff procedure to lift the aircraft from the ground.

land

Initiates the landing procedure to bring the aircraft down safely.

getFlightData

Returns comprehensive flight data including position, speed, attitude, and route status.