English Français العربية

GnuradioMCP

Community Other

Create and modify GNU Radio RF flowcharts (.grc files).

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Marconi 🤖
  2. Requirements
  3. Install
  4. Use it
  5. License

Marconi 🤖

        o)))
        |
    .-------.
    | o   o |
    |   v   |
    '-------'

    Hi! I'm Marco.

LLM-driven RF for Claude Code. Describe what you want on the air and I survey the spectrum, build and run the receiver, look at the signal, and leave a reproducible RF project behind — SigMF captures, YAML pipelines, and .grc flowgraphs you own.

Early development — v1.0 is simulation-only (no hardware yet). See ROADMAP.md.

Proviously known as GNURadio/GR-MCP.

Requirements

  • uv and Python ≥ 3.13
  • GNU Radio 3.10+ installed system-wide (conda-forge, your distro's package manager, or Homebrew) — needed to run pipelines and simulate. Analyzing existing IQ files doesn't require it.

Install

In Claude Code:

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

That's it — uv starts the MCP server on first use and loads the skills. Nothing else to configure.

Use it

Ask in plain language:

"Simulate an FM station at 100.3 MHz and build me a receiver."

"Here's a capture, mystery.wav — survey what's on the air, then decode the strongest carrier."

I pick the right skill and drive the workflow end to end:

  • survey-spectrum — what's present (PSD, signal detection, spectrogram)
  • simulate-scene — register a simulated device from a description
  • build-receiver — channelize, demodulate, validate, run, verify, save
  • debug-no-signal — locate the fault when a receiver outputs nothing
  • tx-experiment — closed-loop transmit-then-receive in simulation
  • escape-hatch — drop to the Python library when no tool fits

Artifacts land under artifacts/ in the server's working directory; set MARCONI_WORKSPACE to put them elsewhere.

License

GPL-3.0-or-later.

Frequently asked questions

What is GnuradioMCP?

Create and modify GNU Radio RF flowcharts (.grc files).

How do I install GnuradioMCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is GnuradioMCP open source?

Yes. Its code is on GitHub under the GPL-3.0 license.

Who maintains GnuradioMCP?

It is published by yoelbassin. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.