GR-MCP: A gnuradio MCP Server

1# GR-MCP: A gnuradio MCP Server
2 
3[![Python Version](https://img.shields.io/badge/python-3.13%2B-blue.svg)](https://www.python.org/downloads/release/python-3130/)
4 
5[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/yoelbassin/gnuradioMCP)](https://archestra.ai/mcp-catalog/yoelbassin__gnuradiomcp)
6 
7 
8**GNURadio MCP Server** is a modern, extensible Machine Control Protocol (MCP) server for [GNURadio](https://www.gnuradio.org/), 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.
9 
10> **Why GNURadio MCP Server?**
11> - Automate SDR workflows and flowgraph generation
12> - Integrate with LLMs, bots, and custom tools
13> - Build, modify, and validate flowgraphs programmatically
14> - Save time and reduce manual errors in SDR prototyping
15 
16 
17## Features
18- 🌐 **MCP API**: Exposes a robust MCP interface for GNURadio
19- 🛠️ **Programmatic Flowgraph Creation**: Build, edit, and save `.grc` files from code or automation
20- 🤖 **LLM & Automation Ready**: Designed for AI and automation integration
21- 🧩 **Extensible**: Modular architecture for easy extension and customization
22- 📝 **Example Flowgraphs**: Includes ready-to-use `.grc` examples in the `misc/` directory
23- 🧪 **Tested**: Comprehensive unit tests with `pytest`
24 
25 
26## Quickstart
27 
28### Requirements
29- Python >= 3.13
30- GNURadio (Tested with GNURadio Companion v3.10.12.0)
31- UV
32 
33### Usage
341. **Clone the repository**
35```bash
36git clone https://github.com/yoelbassin/gr-mcp
37```
38 
392. [**Install GNURadio**](https://wiki.gnuradio.org/index.php/InstallingGR)
40 
413. **Set up a UV environment**
42```bash
43cd gr-mcp
44uv venv --system-site-packages
45```
46   > The `--system-site-packages` flag is required because GNURadio installs the `gnuradio` Python package globally.
47 
484. **Add the MCP server configuration to your client configuration.** For example, for Claude Desktop or Cursor:
49```json
50"mcpServers": {
51    "gr-mcp": {
52      "command": "uv",
53      "args": [
54        "--directory",
55        "/path/to/gr-mcp",
56        "run",
57        "main.py"
58      ]
59    }
60  }
61```
62 
63## Development
64Install development dependencies and run tests with:
65```bash
66pip install -e ".[dev]"
67pytest
68```
69 
70 
71## Project Status
72**In active development.** Core server functionality is available, but the API and features are evolving. Your feedback and contributions are highly valued!
73