by yoelbassin
GR-MCP is a Machine Control Protocol (MCP) server for GNU Radio that enables programmatic and AI-driven creation and modification of GNU Radio flowgraphs. It facilitates seamless integration with LLMs and automation frameworks to control Software Defined Radio (SDR) workflows at scale.
GR-MCP is a modern, extensible Machine Control Protocol (MCP) server specifically designed for GNU Radio. It enables programmatic, automated, and AI-driven creation and modification of GNU Radio flowgraphs (.grc files). This server facilitates seamless integration with Large Language Models (LLMs), automation frameworks, and custom clients, allowing users to control Software Defined Radio (SDR) workflows at scale.
To use GR-MCP, you need Python 3.13+ and GNU Radio (tested with v3.10.12.0). Follow these steps:
git clone https://github.com/yoelbassin/gr-mcp
gr-mcp
directory and run uv venv --system-site-packages
. The --system-site-packages
flag is crucial as GNU Radio installs its Python package globally.mcpServers
entry in your client's JSON configuration. An example configuration is provided in the project's README..grc
files programmatically from code or automation scripts..grc
examples in the misc/
directory to help users get started quickly.Q: Why use GR-MCP? A: GR-MCP helps automate SDR workflows and flowgraph generation, integrates with LLMs and custom tools, allows programmatic building, modification, and validation of flowgraphs, and saves time by reducing manual errors in SDR prototyping.
Q: What are the requirements for GR-MCP? A: You need Python >= 3.13, GNU Radio (tested with v3.10.12.0), and UV (a Python package installer and resolver).
Q: Is GR-MCP actively developed? A: Yes, GR-MCP is in active development. Core server functionality is available, and the API and features are continuously evolving. Feedback and contributions are highly valued.
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
.grc
files from code or automation.grc
examples in the misc/
directorypytest
git clone https://github.com/yoelbassin/gr-mcp
Set up a UV environment
cd gr-mcp
uv venv --system-site-packages
The
--system-site-packages
flag is required because GNURadio installs thegnuradio
Python package globally.
"mcpServers": {
"gr-mcp": {
"command": "uv",
"args": [
"--directory",
"/path/to/gr-mcp",
"run",
"main.py"
]
}
}
Install development dependencies and run tests with:
pip install -e ".[dev]"
pytest
In active development. Core server functionality is available, but the API and features are evolving. Your feedback and contributions are highly valued!
Reviews feature coming soon
Stay tuned for community discussions and feedback