GR-MCP logo

GR-MCP

by yoelbassin

GR-MCP is a modern Machine Control Protocol (MCP) server for GNURadio, enabling programmatic and automated creation of flowgraphs. It's designed for seamless integration with LLMs and automation frameworks, empowering you to control SDR workflows at scale.

View on GitHub

Last updated: N/A

What is GR-MCP?

GR-MCP is a Machine Control Protocol (MCP) server for GNURadio that allows for programmatic creation, modification, and control of GNURadio flowgraphs. It provides an API to interact with GNURadio, enabling automation and integration with tools like Large Language Models (LLMs).

How to use GR-MCP?

To use GR-MCP, clone the repository, install GNURadio and UV, set up a UV environment, and configure your client (e.g., Claude Desktop or Cursor) to use the GR-MCP server. The README provides detailed instructions and example configurations.

Key features of GR-MCP

  • MCP API

  • Programmatic Flowgraph Creation

  • LLM & Automation Ready

  • Extensible Modular Architecture

Use cases of GR-MCP

  • Automating SDR workflows

  • Integrating with LLMs and bots

  • Building and modifying flowgraphs programmatically

  • Reducing manual errors in SDR prototyping

FAQ from GR-MCP

What is the minimum Python version required?

Python 3.13 or higher is required.

Which GNURadio version is supported?

It has been tested with GNURadio Companion v3.10.12.0.

What is the purpose of the --system-site-packages flag?

The --system-site-packages flag is required because GNURadio installs the gnuradio Python package globally.

Is the project stable?

The project is in active development, and the API and features are evolving. Core server functionality is available.

Where can I find example flowgraphs?

Ready-to-use .grc examples are located in the misc/ directory.