Which integrations are available for this server?

Provides an MCP interface for GNURadio, allowing programmatic creation, modification, and validation of flowgraphs and SDR workflows Built for Python 3.13+ compatibility, enabling Python-based automation of GNURadio workflows

How do I use GnuRadio?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@GnuRadio create a simple FM receiver flowgraph for 98.5 MHz" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

GR-MCP: A gnuradio MCP Server

Python Version

Trust Score

GNURadio MCP Server is a modern, extensible Machine Control Protocol (MCP) server for GNURadio, enabling programmatic, automated, and AI-driven creation of GNURadio flowgraphs. Designed for seamless integration with Large Language Models (LLMs), automation frameworks, and custom clients, it empowers you to generate .grc files and control SDR workflows at scale.

Why GNURadio MCP Server?
Automate SDR workflows and flowgraph generation
Integrate with LLMs, bots, and custom tools
Build, modify, and validate flowgraphs programmatically
Save time and reduce manual errors in SDR prototyping

Features

🌐 MCP API: Exposes a robust MCP interface for GNURadio
🛠️ Programmatic Flowgraph Creation: Build, edit, and save .grc files from code or automation
🤖 LLM & Automation Ready: Designed for AI and automation integration
🧩 Extensible: Modular architecture for easy extension and customization
📝 Example Flowgraphs: Includes ready-to-use .grc examples in the misc/ directory
🧪 Tested: Comprehensive unit tests with pytest

Related MCP server: Crowdlistening

Quickstart

Requirements

Python >= 3.13
GNURadio (Tested with GNURadio Companion v3.10.12.0)
UV

Usage

Clone the repository

git clone https://github.com/yoelbassin/gr-mcp

Install GNURadio
Set up a UV environment

cd gr-mcp uv venv --system-site-packages

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

Add the MCP server configuration to your client configuration. For example, for Claude Desktop or Cursor:

"mcpServers": { "gr-mcp": { "command": "uv", "args": [ "--directory", "/path/to/gr-mcp", "run", "main.py" ] } }

Development

Install development dependencies and run tests with:

pip install -e ".[dev]" pytest

Project Status

In active development. Core server functionality is available, but the API and features are evolving. Your feedback and contributions are highly valued!