GnuradioMCP

What yoelbassin/gnuradioMCP MCP server does

yoelbassin/gnuradioMCP MCP server connects an LLM-driven workflow to GNU Radio for RF experimentation in simulation. It accepts plain-language descriptions such as a request to simulate an FM station or inspect a capture, then selects a workflow for spectrum inspection, receiver construction, or troubleshooting.

The output is intended to remain usable outside the conversation. Generated work can include GNU Radio .grc flowgraphs, YAML pipeline files, and SigMF captures. These artifacts are stored below the server workspace, giving developers files they can inspect and reuse.

How it works

The project organizes its behavior into named skills rather than requiring the user to manually assemble every processing step. survey-spectrum examines available signal data using PSD, signal detection, and spectrogram analysis. simulate-scene registers a simulated device from a description. build-receiver handles receiver construction tasks including channelization, demodulation, validation, execution, verification, and saving.

When a receiver produces no output, debug-no-signal is the workflow for locating the fault. tx-experiment supports a closed-loop transmit-then-receive experiment in simulation. If none of the defined workflows fits, escape-hatch provides access to the underlying Python library.

GNU Radio runs the pipelines and simulations when installed. Existing IQ-file analysis can be performed without GNU Radio, according to the project requirements.

Setup and configuration

To run yoelbassin/gnuradioMCP MCP server through the documented path, install uv, Python 3.13 or newer, and GNU Radio 3.10 or newer. GNU Radio may be installed with conda-forge, a distribution package manager, or Homebrew.

The documented installation targets Claude Code. Add the yoelbassin/gr-mcp marketplace and install the marconi plugin. On first use, uv starts the MCP server and loads its skills; the documented setup does not require additional configuration. Set MARCONI_WORKSPACE when artifacts should be written somewhere other than the server's default working directory.

Tools and capabilities

The yoelbassin/gnuradioMCP MCP server supports these documented workflows:

• Surveying spectrum with PSD, signal detection, and spectrogram analysis.
• Registering simulated devices from natural-language descriptions.
• Building, running, validating, and verifying receivers.
• Channelizing and demodulating signals as part of receiver construction.
• Diagnosing receivers that produce no signal.
• Running simulated transmit-then-receive experiments.
• Falling back to the Python library when a predefined workflow is insufficient.

The resulting project files can include .grc flowgraphs, YAML pipelines, and SigMF captures.

Limitations and notes

yoelbassin/gnuradioMCP MCP server is explicitly marked as early development, and version 1.0 is simulation-only.

The project was previously known as GNURadio/GR-MCP. GNU Radio is not required for existing IQ-file analysis, but it is required to run pipelines and simulations. The stated license is GPL-3.0-or-later.