GR-MCP: A gnuradio MCP Server

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
   

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