GNU Radio MCP Server (`gr-mcp`)

gr-mcp is an MCP server that exposes GNU Radio flowgraph operations as tools for AI assistants and automation clients. It is built on FastMCP and designed for programmatic SDR workflow generation, editing, validation, and export.

What It Provides

Discovery of available GNU Radio blocks
Programmatic block creation and removal
Block parameter read/write operations
Connection and disconnection between blocks
Flowgraph validation and error inspection
Flowgraph persistence to .grc

Requirements

Python >=3.13
GNU Radio installed and available to Python (tested with GNU Radio Companion 3.10.12.0)
uv

Installation

Clone the repository:

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

Install GNU Radio if it is not already installed:

GNU Radio installation guide

Create a virtual environment that can see system GNU Radio packages:

uv venv --system-site-packages

The --system-site-packages flag is required because GNU Radio is commonly installed as a system-level Python package.

Run with an MCP Client

Add gr-mcp to your MCP client configuration (for example, Cursor or Claude Desktop):

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

Development

Install development dependencies and run tests:

pip install -e ".[dev]"
pytest

Project Status

This project is under active development. Core functionality is available, and interfaces may evolve as the server matures.

yoelbassin/gnuradioMCP

GNU Radio MCP Server (gr-mcp)