Gr Mcp

What is Gr Mcp about?

Gr Mcp offers a robust MCP interface for GNURadio, allowing developers to generate and manipulate .grc flowgraph files through code, scripts, or AI agents. It streamlines the SDR prototyping process by removing manual GUI steps.

How to use Gr Mcp?

1. Clone the repository: git clone https://github.com/yoelbassin/gr-mcp.
2. Install GNURadio (v3.10.12.0 or compatible).
3. Create a UV virtual environment with system packages: uv venv --system-site-packages.
4. Add the server to your client configuration, e.g.,

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

5. Run the server and interact via the MCP protocol from your automation or LLM tooling.

Key features of Gr Mcp

• MCP API: Fully documented protocol for remote GNURadio control.
• Programmatic Flowgraph Creation: Build, edit, and save .grc files via Python code.
• LLM & Automation Ready: Designed for seamless AI integration.
• Extensible Architecture: Modular plugins for custom blocks and workflows.
• Example Flowgraphs: Ready‑to‑use samples in misc/.
• Test Coverage: Unit tests powered by pytest.

Use cases of Gr Mcp

• Automatic generation of SDR pipelines for large‑scale signal analysis.
• Integration with AI assistants to design and tune flowgraphs on‑the‑fly.
• Continuous integration pipelines that validate GNURadio configurations.
• Custom client applications that need remote GNURadio control without a GUI.

FAQ from the Gr Mcp

Q: Which Python version is required? A: Python 3.13 or newer.

Q: Do I need to reinstall GNURadio inside the virtual environment? A: No. Use the --system-site-packages flag so the globally installed GNURadio package is visible.

Q: How are updates handled? A: Pull the latest changes from the repository and reinstall the development dependencies with pip install -e "[dev]".

Q: Is the API stable? A: The project is in active development; core functionality is stable, but the API may evolve.

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 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

Quickstart

Requirements

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

Usage

1. Clone the repository

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

2. Install GNURadio

3. 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.

4. 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!