Gnuradio

Gnuradio

An MCP server for GNU Radio that enables LLMs to autonomously create and modify RF .grc flowcharts.

20
Stars
4
Forks
0
Releases

Overview

GR-MCP is a modern, extensible Machine Control Protocol (MCP) server for GNURadio that enables programmatic, automated, and AI-driven creation of GNURadio flowgraphs. Designed for seamless integration with Large Language Models (LLMs), automation frameworks, and custom clients, it empowers users to generate .grc files and control SDR workflows at scale. The server exposes a robust MCP API and supports building, editing, and saving flowgraphs from code or automation, making it easy to integrate GNURadio development into automated pipelines. Its modular, extensible architecture invites custom components and adapters, while the included example flowgraphs in the misc/ directory provide ready-to-run starting points. The project emphasizes testability, with comprehensive unit tests powered by pytest. Quickstart steps highlight Python >= 3.13, GNURadio (tested with GNURadio Companion v3.10.12.0), and UV-based virtual environments, including a sample client configuration to register the gr-mcp server for UV tooling. The project is in active development, with core functionality available and API/features continually evolving.

Details

Owner
yoelbassin
Language
Python
License
GNU General Public License v3.0
Updated
2025-12-07

Features

MCP API

Exposes a robust MCP interface for GNURadio.

Programmatic Flowgraph Creation

Build, edit, and save `.grc` files from code or automation.

LLM & Automation Ready

Designed for AI and automation integration.

Extensible

Modular architecture for easy extension and customization.

Example Flowgraphs

Includes ready-to-use `.grc` examples in the `misc/` directory.

Tested

Comprehensive unit tests with `pytest`.

Audience

LLM developersUse LLMs to autonomously generate and modify GNURadio flowgraphs at scale.
Automation engineersAutomation engineers can orchestrate SDR workflows with AI-assisted flowgraph creation.
GNURadio developersGNURadio developers can programmatically build and modify .grc files efficiently.

Tags

gnuradiomcpllmaiflowgraphgrcautomationextensible