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
- Stars
- 20★
- Forks
- 7
- Language
- Python
- License
- —
- Created
- 2025-07-27
- Last push
- 2026-07-21