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:

cd /mnt/c/Users/Michael/fsd-mcp-server
bun run index.ts

From Windows:

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):

{
  "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