Servidor MCP de GNU Radio (gr-mcp)

gr-mcp es un servidor MCP que expone las operaciones de diagramas de flujo de GNU Radio como herramientas para asistentes de IA y clientes de automatización. Está construido sobre FastMCP y diseñado para la generación, edición, validación y exportación programática de flujos de trabajo SDR.

Qué proporciona

• Descubrimiento de bloques de GNU Radio disponibles

• Creación y eliminación programática de bloques

• Operaciones de lectura/escritura de parámetros de bloques

• Conexión y desconexión entre bloques

• Validación de diagramas de flujo e inspección de errores

• Persistencia de diagramas de flujo en .grc

Related MCP server: Crowdlistening

Requisitos

• Python >=3.13

• GNU Radio instalado y disponible para Python (probado con GNU Radio Companion 3.10.12.0)

• uv

Instalación

1. Clona el repositorio:

git clone https://github.com/yoelbassin/gr-mcp
cd gr-mcp

2. Instala GNU Radio si aún no está instalado:

• Guía de instalación de GNU Radio

3. Crea un entorno virtual que pueda ver los paquetes de GNU Radio del sistema:

uv venv --system-site-packages

La bandera --system-site-packages es necesaria porque GNU Radio se instala habitualmente como un paquete de Python a nivel de sistema.

Ejecutar con un cliente MCP

Añade gr-mcp a la configuración de tu cliente MCP (por ejemplo, Cursor o Claude Desktop):

{
  "mcpServers": {
    "gr-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/gr-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Desarrollo

Instala las dependencias de desarrollo y ejecuta las pruebas:

pip install -e ".[dev]"
pytest

Estado del proyecto

Este proyecto está en desarrollo activo. La funcionalidad principal está disponible y las interfaces pueden evolucionar a medida que el servidor madure.