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
.grc
files from code or automationLLM & 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 themisc/
directoryTested: 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
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 thegnuradio
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!
GNURadio MCP Server
Project Details
- yoelbassin/gr-mcp
- GNU General Public License v3.0
- Last Updated: 5/12/2025
Recomended MCP Servers
A Claude MCP server providing secure access to Android project files for AI-assisted code navigation and analysis.
MCP Portal Project
Clockify Model Context Protocol (MCP) server
FreecadMCP connects Freecad to Claude AI and other MCP-ready tools like Cursor through the Model Context Protocol (MCP),...
Revit MCP. A Model Context Protocol server for Revit integration, enabling seamless communication between Claude AI and Autodesk...
MCP Server to search individual private Github Repositories
MCP server integration for DaVinci Resolve
MCP Server (Model Context Protocol) for turning OpenAPI specifications into a MCP Resource
mcp metabase
A Model Context Protocol (MCP) server for generating simple QR codes. Support custom QR code styles.