Servidor MCP SDR

Control de IA conversacional para radio definida por software a través del Protocolo de Contexto de Modelo.

Controle hardware RTL-SDR mediante diálogo natural: consulte el espectro, sintonice frecuencias, explore bases de datos de emisoras y visualice pantallas de cascada en tiempo real. Funciona con Claude Desktop, cualquier cliente MCP o el panel web incluido.

Inicio rápido

# Install
pip install sdr-mcp

# Check hardware
sdr-mcp check

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

Para el panel web:

cd web_sota
npm install
npm run dev

Documentación

Características

Control de hardware

• Detección automática de dispositivos RTL-SDR, inicialización y configuración

• Ajuste de frecuencia (24 MHz — 1.766 GHz), ganancia (automática o manual)

• Captura de muestras IQ en tiempo real y procesamiento de espectro

Análisis de espectro

• FFT de 2048 puntos con ventana de Hamming

• Detección de picos y análisis de intensidad de señal

• Historial de cascada (100 líneas) para señales que varían en el tiempo

Base de datos de frecuencias

• 11 emisoras precargadas en bandas LW/MW/SW/VHF

• Programación con información de lo que se está reproduciendo actualmente

• Búsqueda en línea a través de radio-browser.info (más de 25.000 emisoras)

Transmisión por WebSocket

• Difusión de espectro en tiempo real a clientes web

• Control remoto de frecuencia/ganancia mediante comandos WebSocket

• Visualizaciones de espectro y cascada basadas en Canvas

Panel web

• Analizador de espectro: gráfico FFT en vivo con controles de frecuencia/ganancia

• Pantalla de cascada: visualización de tiempo-frecuencia codificada por colores

• Navegador de emisoras: búsqueda, favoritos, filtros de banda

• Base de datos en línea: consulta radio-browser.info por nombre/país/género

• Identificación de señales: búsqueda de tipos de señal en SigID Wiki

Hardware

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

• Cobertura continua de 24 MHz — 1.766 GHz

• TCXO de 0.5 ppm para estabilidad de frecuencia

• Conector SMA, carcasa de aluminio, bias tee

Cualquier SDR basado en RTL2832U con sintonizador R820T2 funciona. Consulte RTL_SDR_V4.md para ver las especificaciones completas.

Estructura del proyecto

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

Stack tecnológico

Licencia

MIT