Skip to content

AetherLink SDR MCP

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

Install

$uvx aetherlink --setup
Claude Code
claude mcp add aetherlink-sdr-mcp -- uvx aetherlink --setup
Cursor / Claude Desktop (mcp.json)
{
  "mcpServers": {
    "aetherlink-sdr-mcp": {
      "command": "uvx",
      "args": [
        "aetherlink",
        "--setup"
      ]
    }
  }
}

Install command taken from the project's README or registry entry. Always review code before running it.

AetherLink-SDR-MCP: Software Defined Radio Model Context Protocol Server

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

Features

  • Protocol Decoders: ADS-B aircraft tracking, POCSAG pagers, AIS ship tracking, Meteor-M LRPT satellites, ISM band devices
  • Weather Satellites: Meteor-M2-3/M2-4 LRPT decoding with SatDump
  • Advanced Analysis: Real-time spectrum analysis, waterfall displays, signal detection, frequency scanning
  • Audio Recording: Demodulate and record FM/AM audio as WAV files
  • ISM Band Scanning: Decode 433MHz/315MHz devices (weather stations, sensors, doorbells, tire pressure monitors)
  • MCP Integration: Seamless integration with Claude Desktop and other MCP clients
  • 26 MCP Tools: Complete SDR control through natural language

Installation

From PyPI (Recommended)

pip install aetherlink
aetherlink --setup

That's it. The --setup command auto-configures Claude Desktop -- it detects your OS, finds the config file, and adds AetherLink without touching your other MCP servers. Then restart Claude Desktop.

Or if you prefer uvx (no install needed):

uvx aetherlink --setup

Note: You still need RTL-SDR system drivers installed. See System Dependencies below.

Full Installer (includes system drivers)

macOS / Linux:

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

Windows (PowerShell):

irm https://raw.githubusercontent.com/N-Erickson/AetherLink-SDR-MCP/main/install.ps1 | iex

The installer handles everything: system drivers, Python package, optional decoders, and Claude Desktop configuration.

Windows users: You also need Zadig to replace the RTL-SDR USB driver with WinUSB. The installer will walk you through this.

System Dependencies

AetherLink requires RTL-SDR drivers installed at the system level:

Tool macOS Ubuntu/Debian Purpose
RTL-SDR brew install rtl-sdr sudo apt install rtl-sdr librtlsdr-dev Required - SDR drivers
dump1090 brew install dump1090-fa sudo apt install dump1090-fa Optional - ADS-B aircraft tracking
rtl_433 brew install rtl_433 sudo apt install rtl-433 Optional - ISM band devices
SatDump brew install satdump PPA instructions Optional - satellite imaging
multimon-ng Built from source by installer sudo apt install multimon-ng Optional - POCSAG pagers

Install from source (development)

git clone https://github.com/N-Erickson/AetherLink-SDR-MCP
cd AetherLink-SDR-MCP
python3 -m venv venv
source venv/bin/activate
pip install -e ".[dev]"

Quick Start

1. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or equivalent:

{
  "mcpServers": {
    "aetherlink": {
      "command": "/path/to/AetherLink-SDR-MCP/venv/bin/python",
      "args": ["-m", "sdr_mcp.server"],
      "cwd": "/path/to/AetherLink-SDR-MCP"
    }
  }
}

Important: Replace /path/to/ with your actual path. Run which python with your venv activated to find the correct Python path.

2. Restart Claude Desktop

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Java 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

Explore related