Gr Mcp
What is Gr Mcp
gr-mcp is a modern, extensible Machine Control Protocol (MCP) server designed for GNURadio, enabling automated and AI-driven creation of GNURadio flowgraphs.
Use cases
Use cases include automating SDR workflows, generating flowgraphs programmatically, and integrating with AI tools for enhanced functionality.
How to use
To use gr-mcp, clone the repository, install GNURadio, set up a UV environment, and configure your client to connect to the MCP server.
Key features
Key features include a robust MCP API, programmatic flowgraph creation, integration readiness for LLMs and automation, extensibility, and comprehensive unit tests.
Where to use
gr-mcp can be used in fields such as software-defined radio (SDR) development, automation frameworks, and AI-driven applications.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Gr Mcp
gr-mcp is a modern, extensible Machine Control Protocol (MCP) server designed for GNURadio, enabling automated and AI-driven creation of GNURadio flowgraphs.
Use cases
Use cases include automating SDR workflows, generating flowgraphs programmatically, and integrating with AI tools for enhanced functionality.
How to use
To use gr-mcp, clone the repository, install GNURadio, set up a UV environment, and configure your client to connect to the MCP server.
Key features
Key features include a robust MCP API, programmatic flowgraph creation, integration readiness for LLMs and automation, extensibility, and comprehensive unit tests.
Where to use
gr-mcp can be used in fields such as software-defined radio (SDR) development, automation frameworks, and AI-driven applications.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
GR-MCP: A gnuradio MCP Server
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
.grcfiles 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
.grcexamples in themisc/directory - 🧪 Tested: Comprehensive unit tests with
pytest
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
-
Set up a UV environment
cd gr-mcp
uv venv --system-site-packages
The
--system-site-packagesflag is required because GNURadio installs thegnuradioPython package globally.
- Add the MCP server configuration to your client configuration. For example, for Claude Desktop or Cursor:
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!
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
