GNU Radio MCP 服务器 (gr-mcp)

gr-mcp 是一个 MCP 服务器，它将 GNU Radio 流程图操作作为工具暴露给 AI 助手和自动化客户端。它基于 FastMCP 构建，旨在实现程序化的 SDR 工作流生成、编辑、验证和导出。

它提供了什么

• 发现可用的 GNU Radio 模块

• 程序化模块创建和移除

• 模块参数读/写操作

• 模块间的连接和断开

• 流程图验证和错误检查

• 流程图持久化为 .grc 文件

Related MCP server: Crowdlistening

要求

• Python >=3.13

• 已安装并可供 Python 使用的 GNU Radio（已在 GNU Radio Companion 3.10.12.0 上测试）

• uv

安装

1. 克隆仓库：

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

2. 如果尚未安装，请安装 GNU Radio：

• GNU Radio 安装指南

3. 创建一个可以访问系统 GNU Radio 包的虚拟环境：

uv venv --system-site-packages

必须使用 --system-site-packages 标志，因为 GNU Radio 通常作为系统级 Python 包安装。

使用 MCP 客户端运行

将 gr-mcp 添加到您的 MCP 客户端配置中（例如 Cursor 或 Claude Desktop）：

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

开发

安装开发依赖并运行测试：

pip install -e ".[dev]"
pytest

项目状态

本项目处于活跃开发阶段。核心功能可用，随着服务器的成熟，接口可能会发生变化。