What is Gnuradiomcp

gnuradioMCP is a modern, extensible Machine Control Protocol (MCP) server designed for GNURadio, enabling automated and AI-driven creation of flowgraphs, facilitating the generation and control of SDR workflows.

Use cases

Use cases for gnuradioMCP include automating SDR workflows, generating flowgraphs from code, integrating AI models for signal processing tasks, and creating custom SDR applications.

How to use

To use gnuradioMCP, clone the repository, install GNURadio, set up a UV environment, and configure your client to connect to the MCP server. Detailed steps include cloning the repository, installing dependencies, and adding MCP server configurations to your client.

Key features

Key features include a robust MCP API, programmatic flowgraph creation, integration readiness with LLMs and automation tools, an extensible modular architecture, and a collection of example flowgraphs.

Where to use

gnuradioMCP can be used in fields such as software-defined radio (SDR) development, automated testing, AI-driven signal processing, and educational environments for learning about radio communications.

GR-MCP: A gnuradio MCP Server

GNURadio MCP Server is a modern, extensible Machine Control Protocol (MCP) server for GNURadio, enabling 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 you to generate .grc files and control SDR workflows at scale.

Why GNURadio MCP Server?

• Automate SDR workflows and flowgraph generation
• Integrate with LLMs, bots, and custom tools
• Build, modify, and validate flowgraphs programmatically
• Save time and reduce manual errors in SDR prototyping

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

Quickstart

Requirements

• Python >= 3.13
• GNURadio (Tested with GNURadio Companion v3.10.12.0)
• UV

Usage

1. Clone the repository

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

2. Install GNURadio

3. Set up a UV environment

cd gr-mcp
uv venv --system-site-packages

The --system-site-packages flag is required because GNURadio installs the gnuradio Python package globally.

4. Add the MCP server configuration to your client configuration. For example, for Claude Desktop or Cursor:

Development

Install development dependencies and run tests with:

pip install -e ".[dev]"
pytest

Project Status

In active development. Core server functionality is available, but the API and features are evolving. Your feedback and contributions are highly valued!