# yoelbassin/gnuradioMCP [Health: Active]

**Category:** 📟 Embedded System  
**Repository:** https://github.com/yoelbassin/gnuradioMCP  
**GitHub Stars:** 57  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/yoelbassin-gnuradiomcp

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

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/yoelbassin-gnuradiomcp/readme_