fsd-mcp-server/README.md

Model Context Protocol server for accessing real-time FSD (Flight Sim Daemon) data from EuroScope

# FSD MCP Server

A Model Context Protocol (MCP) server that connects to EuroScope's built-in FSD (Flight Sim Daemon) server to read real-time flight simulation data.

## Features

- **Direct FSD Connection**: Connects to EuroScope's built-in FSD server on localhost:6809
- **Real-time Data**: Monitors live FSD protocol messages from EuroScope
- **Message Analysis**: Parses and categorizes FSD protocol messages
- **Pilot/Controller Tracking**: Identifies and tracks pilots and controllers
- **Raw Message Access**: View raw FSD protocol messages for analysis
- **Interactive Control**: Send custom FSD messages to the server

## Available Tools

1. **connect_fsd** - Connect to EuroScope FSD server (default: localhost:6809)
2. **disconnect_fsd** - Disconnect from FSD server
3. **get_fsd_status** - Get connection status and data summary
4. **get_fsd_messages** - Get raw FSD messages with optional filtering
5. **get_fsd_pilots** - Get tracked pilot data
6. **get_fsd_controllers** - Get tracked controller data
7. **send_fsd_message** - Send raw FSD messages to server
8. **get_fsd_protocol_reference** - Get FSD protocol documentation and field definitions
9. **parse_fsd_message** - Parse and explain any raw FSD message with field breakdown
10. **auto_connect_fsd** - Automatically attempt connection with retry logic

## Prerequisites

1. **EuroScope Running**: EuroScope must be running with its built-in FSD server active
2. **FSD Server Enabled**: Ensure EuroScope's simulator/FSD server is started
3. **Port Access**: Default port 6809 must be accessible

## Installation

1. Ensure Bun is installed
2. Dependencies installed via `bun install`

## Running the Server

### From WSL:
```bash
cd /mnt/c/Users/Michael/fsd-mcp-server
bun run index.ts
```

### From Windows:
```cmd
cd C:\Users\Michael\fsd-mcp-server
start-server.bat
```

## Claude Desktop Configuration

Add to your Claude Desktop config (`%APPDATA%\Claude\claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "vatsim": {
      "command": "C:\\Users\\Michael\\vatsim-mcp-server\\start-server.bat"
    },
    "fsd": {
      "command": "C:\\Users\\Michael\\fsd-mcp-server\\start-server.bat"
    }
  }
}
```

## Usage Examples

Once connected to Claude Desktop and EuroScope is running:

- "Connect to the EuroScope FSD server"
- "Show me FSD connection status"
- "What FSD messages have been received?"
- "Show me current pilots in the simulation"
- "Get all controllers online"
- "Send a test FSD message"

## FSD Protocol Overview

The Flight Sim Daemon (FSD) protocol is used by EuroScope for:
- **Client Authentication**: Pilot/controller login and identification
- **Position Updates**: Aircraft position, altitude, heading, speed
- **Flight Plans**: Departure, arrival, route, aircraft type
- **Controller Data**: Frequency, position, ATIS information
- **Network Messages**: Chat, coordination, handoffs

## Data Available

### Input Data (from EuroScope FSD):
- **Pilot Positions**: Real-time aircraft tracking
- **Flight Plans**: Complete flight plan data
- **Controller Information**: Active positions and frequencies
- **Network Messages**: All FSD protocol communications
- **Authentication Events**: Login/logout events

### Output Capabilities:
- **Message Injection**: Send custom FSD messages
- **Data Querying**: Filter and search tracked data
- **Real-time Monitoring**: Live message stream analysis
- **Protocol Analysis**: Parse and understand FSD message structure

## Important Notes

- **Local Only**: Designed for localhost connections to EuroScope
- **Read-Only Focus**: Primarily for monitoring, not controlling
- **Protocol Compliance**: Uses standard FSD protocol formats
- **Non-Intrusive**: Does not interfere with EuroScope operation