GNU Radio MCP-Server (gr-mcp)

gr-mcp ist ein MCP-Server, der GNU Radio-Flowgraph-Operationen als Werkzeuge für KI-Assistenten und Automatisierungs-Clients bereitstellt. Er basiert auf FastMCP und wurde für die programmgesteuerte Erstellung, Bearbeitung, Validierung und den Export von SDR-Workflows entwickelt.

Was er bietet

• Erkennung verfügbarer GNU Radio-Blöcke

• Programmgesteuertes Erstellen und Entfernen von Blöcken

• Lese-/Schreibvorgänge für Blockparameter

• Verbinden und Trennen von Blöcken

• Flowgraph-Validierung und Fehlerüberprüfung

• Flowgraph-Persistenz in .grc-Dateien

Related MCP server: GR-MCP

Anforderungen

• Python >=3.13

• GNU Radio installiert und für Python verfügbar (getestet mit GNU Radio Companion 3.10.12.0)

• uv

Installation

1. Klonen Sie das Repository:

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

2. Installieren Sie GNU Radio, falls es noch nicht installiert ist:

• GNU Radio Installationsanleitung

3. Erstellen Sie eine virtuelle Umgebung, die auf die GNU Radio-Systempakete zugreifen kann:

uv venv --system-site-packages

Das Flag --system-site-packages ist erforderlich, da GNU Radio üblicherweise als Python-Paket auf Systemebene installiert wird.

Ausführung mit einem MCP-Client

Fügen Sie gr-mcp zu Ihrer MCP-Client-Konfiguration hinzu (zum Beispiel Cursor oder Claude Desktop):

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

Entwicklung

Installieren Sie die Entwicklungsabhängigkeiten und führen Sie Tests aus:

pip install -e ".[dev]"
pytest

Projektstatus

Dieses Projekt befindet sich in der aktiven Entwicklung. Die Kernfunktionalität ist verfügbar, und die Schnittstellen können sich mit der Reifung des Servers weiterentwickeln.