SDR MCP-Server

Konversationelle KI-Steuerung für Software Defined Radio über das Model Context Protocol.

Steuern Sie RTL-SDR-Hardware durch natürliche Dialoge — fragen Sie das Spektrum ab, stellen Sie Frequenzen ein, durchsuchen Sie Senderdatenbanken und visualisieren Sie Echtzeit-Wasserfall-Anzeigen. Funktioniert mit Claude Desktop, jedem MCP-Client oder dem enthaltenen Web-Dashboard.

Schnellstart

# Install
pip install sdr-mcp

# Check hardware
sdr-mcp check

# Start server (STDIO mode for Claude Desktop)
sdr-mcp serve

Für das Web-Dashboard:

cd web_sota
npm install
npm run dev

Dokumentation

Funktionen

Hardware-Steuerung

• Automatische Erkennung, Initialisierung und Konfiguration von RTL-SDR-Geräten

• Frequenzeinstellung (24 MHz — 1,766 GHz), Verstärkung (automatisch oder manuell)

• Echtzeit-IQ-Sample-Erfassung und Spektrumverarbeitung

Spektrumanalyse

• 2048-Punkt-FFT mit Hamming-Fenster

• Spitzenerkennung und Signalstärkeanalyse

• Wasserfall-Historie (100 Zeilen) für zeitlich veränderliche Signale

Frequenzdatenbank

• 11 vorinstallierte Sender über LW/MW/KW/UKW-Bänder

• Programmpläne mit Informationen zur aktuellen Sendung

• Online-Suche über radio-browser.info (über 25.000 Sender)

WebSocket-Streaming

• Echtzeit-Spektrum-Übertragung an Web-Clients

• Fernsteuerung von Frequenz/Verstärkung über WebSocket-Befehle

• Canvas-basierte Spektrum- und Wasserfall-Visualisierungen

Web-Dashboard

• Spektrumanalysator — Live-FFT-Plot mit Frequenz-/Verstärkungsreglern

• Wasserfall-Anzeige — farbcodierte Zeit-Frequenz-Visualisierung

• Sender-Browser — Suche, Favoriten, Bandfilter

• Online-DB — Abfrage von radio-browser.info nach Name/Land/Genre

• Signal-ID — Nachschlagen von Signaltypen im SigID Wiki

Hardware

Empfohlen: RTL-SDR Blog v4 (~35 $)

• 24 MHz — 1,766 GHz kontinuierliche Abdeckung

• 0,5 ppm TCXO für Frequenzstabilität

• SMA-Anschluss, Aluminiumgehäuse, Bias-Tee

Jedes RTL2832U-basierte SDR mit R820T2-Tuner funktioniert. Siehe RTL_SDR_V4.md für vollständige Spezifikationen.

Projektstruktur

sdr-mcp/
├── README.md              # This file
├── docs/                  # Documentation
│   ├── INSTALL.md         # Setup guide
│   ├── ARCHITECTURE.md    # System design
│   ├── MCP_SERVER.md      # Tool reference
│   ├── SDR_TECHNOLOGY.md  # Radio primer
│   └── RTL_SDR_V4.md      # Hardware specs
├── pyproject.toml         # Python package config
├── justfile               # Lint, fix, security recipes
├── start.ps1              # Launch backend + webapp
├── src/sdr_mcp/           # Python backend
│   ├── server.py          # FastMCP server, 17 tools
│   ├── capture.py         # RTL-SDR hardware interface
│   ├── processor.py       # FFT / spectrum processing
│   ├── frequency_db.py    # Station database
│   ├── online_db.py       # radio-browser.info API
│   ├── websocket_server.py # Real-time WebSocket stream
│   ├── transport.py       # STDIO / HTTP transport
│   └── cli.py             # Command-line interface
├── web_sota/              # React/TypeScript webapp
│   └── src/
│       ├── pages/         # Spectrum, Waterfall, Stations, etc.
│       └── components/    # Layout, UI components
└── tests/                 # Pytest test suite

Tech-Stack

Lizenz

MIT