N-Erickson/AetherLink-SDR-MCP

View on GitHub ↗

MCP server for Software Defined Radio — control RTL-SDR & HackRF from Claude/LLM. ADS-B aircraft tracking, AIS ship tracking, POCSAG pager decoding, Meteor-M satellite imaging, ISM band scanning, spectrum analysis, and more.

20 ★7 forksPythonUpdated 1mo ago

What you need to know

Software-defined radio MCP server that controls RTL-SDR/HackRF hardware and decodes radio protocols (ADS-B, POCSAG, AIS, Meteor-M LRPT, ISM-band devices) through 26 natural-language MCP tools.

Install

pip install aetherlink && aetherlink --setup
uvx aetherlink --setup
curl -fsSL https://raw.githubusercontent.com/N-Erickson/AetherLink-SDR-MCP/main/install.sh | bash

Usage

  • Ask your agent to 'Connect to my RTL-SDR', then track aircraft (1090 MHz), decode pagers at 152.240 MHz, or scan ISM bands at 433.92/315 MHz.
  • Record demodulated FM/AM audio or raw IQ samples — saved to /tmp/sdr_recordings/.
  • Decode a Meteor-M satellite pass while overhead (SatDump installed, V-dipole tuned to 137 MHz, elevation >30°).
  • HackRF adds transmit: set TX gain and generate/transmit signals with signal_generator.

Key features

  • 26 MCP tools: core SDR control, aviation (ADS-B via dump1090 + pyModeS), POCSAG pagers (multimon-ng), AIS vessels (built-in GMSK), Meteor-M LRPT (SatDump), ISM scanning (rtl_433).
  • Real-time spectrum analysis, waterfall, signal detection and frequency scanning.
  • Auto-configures Claude Desktop via --setup on macOS/Windows/Linux.
  • Exclusive device access with automatic handoff between Python SDR control and subprocess decoders.

Best for

Radio enthusiasts and researchers who want to monitor aircraft, ships, pagers, weather satellites or ISM devices from an AI chat interface.

Caveats

  • Requires RTL-SDR system drivers installed; Windows additionally needs Zadig (WinUSB driver replacement).
  • Only one program can use the SDR at a time ('Device busy' if GQRX/SDR# is open); Linux needs udev rules and dvb_usb_rtl28xxu blacklist.
  • E4000-based dongles skip 1084–1239 MHz; HackRF TX support is marked limited.
  • Some decoders are optional (dump1090, rtl_433, satdump, multimon-ng) and must be installed separately.
Platforms: Local · macOS · Windows · LinuxClients: Claude Desktop · Any MCP client

Reviewed 2026-08-18

Topics

adsbaiai-agentsaisclaudehackrfllmllm-toolsmcpmcp-serversmcp-toolsmodel-context-protocolradiortl-sdrsatellitesdrspectrum-analysis
Stars
20★
Forks
7
Language
Python
License
Created
2025-07-27
Last push
2026-07-21