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 support without GNU Radio
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

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

Device	RX Frequency	TX Support	Status
RTL-SDR	24 MHz - 1.7 GHz	❌	✅ Stable
HackRF	1 MHz - 6 GHz	✅	🚧 Beta
PlutoSDR	70 MHz - 6 GHz	✅	📋 Planned
USRP	Varies	✅	📋 Planned

📊 Protocol Support

Protocol	Description	Status
ADS-B	Aircraft tracking	✅ Stable
AIS	Ship tracking	🚧 Beta
NOAA APT	Weather satellites	🚧 Beta
FT8/WSPR	Amateur radio	📋 Planned
LoRa	IoT devices	📋 Planned

🛠️ Available Tools

Tool	Description
`sdr_connect`	Connect to SDR hardware
`sdr_disconnect`	Disconnect from SDR
`sdr_set_frequency`	Set center frequency
`sdr_set_gain`	Set gain
`sdr_get_status`	Get hardware status
`aviation_track_aircraft`	Start ADS-B tracking
`spectrum_analyze`	Analyze RF spectrum
`spectrum_scan`	Scan frequency range
`recording_start/stop`	Record IQ samples

🔧 Development

Running Tests

pytest tests/

Docker Support

docker-compose up

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables control of Software Defined Radios and decoding of radio protocols through an AI-friendly Model Context Protocol interface, supporting RTL-SDR and HackRF hardware for signal analysis and protocol decoding.

Related MCP Servers

F5 MCP Server
czirakim
-
security
A
license
-
quality
A Model Context Protocol server that enables management of F5 devices through natural language commands, allowing users to create, update, list, and delete network objects like virtual servers, pools, and iRules via the iControl REST API.
Last updated -
5
Python
MIT License
MCP Hardware Access Library
UnitApi
-
security
A
license
-
quality
A Python framework that enables secure hardware control through the Model Context Protocol, allowing AI agents and automation systems to interact with physical devices across multiple platforms.
Last updated -
Python
Apache 2.0
MCP Android Agent
nim444
-
security
A
license
-
quality
A Model Context Protocol server that enables AI agents to control and automate Android devices through natural language, supporting actions like app management, UI interactions, and device monitoring.
Last updated -
14
Python
MIT License
Shadcn UI MCP Server
heilgar
A
security
A
license
A
quality
A Model Control Protocol server that allows users to discover, install, and manage Shadcn UI components and blocks through natural language interactions in compatible AI tools.
Last updated -
6
768
8
TypeScript
MIT License

View all related MCP servers