gnuradioMCP logo

gnuradioMCP

yoelbassin/gnuradioMCP
Community

Is this your server?

Add your score badge to your README and get your server in front of 45k+ builders a month.

Works with

Claude CodeClaude DesktopCursorVS CodeClineCodex CLIOpenClaw+ any MCP client

Install to Claude Code

This server doesn't publish a one-line install command. Follow the setup in the source repository.

Summary

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

README.md

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.

See related servers & alternatives →

Related MCP servers

Browse all →

Related guides

Hand-picked reading to help you choose and use AI & ML servers.