GNURadio MCP Server

GNURadio MCP Server is an advanced, extensible Machine Control Protocol (MCP) server tailored for GNURadio. This powerful tool facilitates the programmatic, automated, and AI-driven creation of GNURadio flowgraphs, allowing users to generate .grc files and manage Software Defined Radio (SDR) workflows efficiently.

Key Benefits

• Automate SDR workflows: Streamline the generation and management of flowgraphs, reducing the time and effort associated with manual creation.
• Seamless LLM Integration: Designed to work harmoniously with Large Language Models (LLMs) and automation frameworks, enhancing the capabilities of SDR applications.
• Programmatic Access: Build, modify, and validate flowgraphs directly from code, enhancing flexibility and efficiency in SDR prototyping.

Features

• 🌐 MCP API: Provides a robust interface for GNURadio, simplifying communication and control of flowgraphs.
• 🛠️ Programmatic Flowgraph Creation: Create, edit, and save .grc files programmatically through code or automation tools.
• 🤖 LLM & Automation Readiness: Optimized for integration with AI tools and automation systems.
• 🧩 Extensible Architecture: A modular design allows for easy customization and extension of functionalities.
• 📝 Example Flowgraphs Included: Access a collection of ready-to-use .grc examples available in the misc/ directory.
• 🧪 Robust Testing: Comprehensive unit tests developed using pytest ensure reliability and performance.

Getting Started

To utilize the GNURadio MCP Server, ensure you have the following requirements met:

• Python version 3.13 or higher
• GNURadio (compatible with GNURadio Companion v3.10.12.0)
• UV for environment management.

Usage Example: Clone the repository and set up your environment:

git clone https://github.com/yoelbassin/gnuradioMCP
cd gnuradioMCP
uv venv --system-site-packages

Configure your MCP server connection in your client configuration file:

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

Development Status

The project is actively being developed, with core server functionality already implemented. Features and the API continue to evolve, and contributions and feedback are encouraged to enhance the community and tool assistance.