GNURadio MCP Server

What is GNURadio MCP Server?

GNURadio MCP Server (formerly GR-MCP, now called Marconi) is an LLM-driven RF tool for Claude Code. It lets you describe what you want on the air in plain language, then surveys the spectrum, builds and runs receivers, examines signals, and leaves behind reproducible RF projects (SigMF captures, YAML pipelines, .grc flowgraphs). It is currently simulation-only — no hardware support yet.

How to use GNURadio MCP Server?

Install it in Claude Code by running /plugin marketplace add yoelbassin/gr-mcp then /plugin install marconi. The uv tool starts the MCP server on first use with no further configuration. Ask in plain language, for example "Simulate an FM station at 100.3 MHz and build me a receiver." Artifacts are saved under artifacts/ in the server’s working directory, or can be redirected via the MARCONI_WORKSPACE environment variable.

Key features of GNURadio MCP Server

• Survey spectrum (PSD, signal detection, spectrogram)
• Simulate a registered device from a description
• Build, demodulate, validate, and run a receiver
• Debug when a receiver outputs no signal
• Closed-loop transmit-then-receive in simulation
• Escape hatch to direct Python library access

Use cases of GNURadio MCP Server

• Simulate a radio station and automatically build a matching receiver
• Analyze an existing IQ capture file to detect and decode signals
• Debug a receiver that produces no output
• Run reproducible RF experiments in simulation

FAQ from GNURadio MCP Server

What software dependencies does it require?

It requires uv, Python ≥ 3.13, and GNU Radio 3.10+ installed system-wide (via conda-forge, package manager, or Homebrew). Analyzing existing IQ files does not need GNU Radio.

Where are the generated artifacts stored?

Artifacts land under artifacts/ in the server’s working directory. You can set the MARCONI_WORKSPACE environment variable to place them elsewhere.

Does it support real hardware?

No — v1.0 is simulation-only. Hardware support is planned for future releases (see ROADMAP.md).

How is it installed in Claude Code?

Run /plugin marketplace add yoelbassin/gr-mcp then /plugin install marconi. The server starts automatically on first use.