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

1. Clone the repository:

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

2. Install GNU Radio if it is not already installed:

• GNU Radio installation guide

3. Create a virtual environment:

uv venv

Install as a Claude Code Plugin

The easiest way to use gr-mcp with Claude Code is as a plugin. It handles MCP server setup automatically.

/plugin marketplace add yoelbassin/gr-mcp
/plugin install gr-mcp@gr-mcp

GNU Radio must be installed on your system before installing the plugin.

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.