AetherLink-SDR-MCP

@N-Erickson/AetherLink-SDR-MCP

0 Stars 166 次浏览 N-Erickson 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

服务介绍

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

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

查看源码项目主页