N-Erickson/AetherLink-SDR-MCP

AetherLink: Software Defined Radio Model Context Protocol Server

Control Software Defined Radios and decode radio protocols through an AI-friendly Model Context Protocol interface.

🚀 Features

• Direct Hardware Control: RTL-SDR and HackRF
• Protocol Decoders: ADS-B, AIS, NOAA weather satellites, amateur radio, and more
• Advanced Analysis: Real-time spectrum analysis, waterfall displays, signal identification
• MCP Integration: Seamless integration with Claude and other MCP clients

📦 Installation

Prerequisites

1. RTL-SDR Drivers:

   # Ubuntu/Debian
   sudo apt-get install rtl-sdr librtlsdr-dev
   
   # macOS
   brew install librtlsdr
   
   # Windows
   # Download and install from https://osmocom.org/projects/rtl-sdr/wiki
   

2. Python 3.10+

Install from Source

# Clone the repository
git clone https://github.com/yourusername/aetherlink
cd aetherlink

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install with basic dependencies
pip install -e .

# Install with all protocol decoders
pip install -e ".[decoders]"

# Install with HackRF support
pip install -e ".[hackrf]"

🎯 Quick Start

Configure MCP Client

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "aetherlink": {
      "command": "python",
      "args": ["-m", "sdr_mcp.server"],
      "env": {}
    }
  }
}

Basic Usage

# Connect to RTL-SDR
"Connect to my RTL-SDR"

# Track aircraft
"Track aircraft in my area"

# Analyze spectrum
"Show me what's on the FM broadcast band"

# Scan for signals
"Scan 430-440 MHz for amateur radio activity"

📡 Supported Hardware

📊 Protocol Support

🛠️ Available Tools

🔧 Development

Running Tests

pytest tests/

Docker Support

docker-compose up