GR-MCP: 一个 GNU Radio MCP 服务器

GNU Radio MCP 服务器 是一个现代化、可扩展的机器控制协议（MCP）服务器，适用于 GNU Radio，能够通过编程方式、自动化和 AI 驱动来创建 GNU Radio 流图。该服务器设计用于与大型语言模型（LLMs）、自动化框架和自定义客户端无缝集成，使您能够生成 .grc 文件并大规模控制 SDR 工作流。

为什么选择 GNU Radio MCP 服务器？

• 自动化 SDR 工作流和流图生成
• 与 LLMs、机器人和自定义工具集成
• 通过编程方式构建、修改和验证流图
• 在 SDR 原型设计中节省时间并减少手动错误

功能

• 🌐 MCP API: 为 GNU Radio 提供强大的 MCP 接口
• 🛠️ 程序化流图创建: 从代码或自动化中构建、编辑和保存 .grc 文件
• 🤖 支持 LLM 和自动化: 设计用于 AI 和自动化集成
• 🧩 可扩展性: 模块化架构，易于扩展和定制
• 📝 示例流图: misc/ 目录中包含现成可用的 .grc 示例
• 🧪 经过测试: 使用 pytest 进行全面的单元测试

快速开始

要求

• Python >= 3.13
• GNU Radio (已测试版本为 GNURadio Companion v3.10.12.0)
• UV

使用方法

1. 克隆仓库
   bash
   git clone https://github.com/yoelbassin/gr-mcp

2. 安装 GNU Radio

3. 设置 UV 环境
   bash
   cd gr-mcp
   uv venv --system-site-packages

   由于 GNU Radio 全局安装了 gnuradio Python 包，因此需要使用 --system-site-packages 标志。

4. 将 MCP 服务器配置添加到您的客户端配置中。 例如，对于 Claude Desktop 或 Cursor:
   json
   "mcpServers": {
   "gr-mcp": {
   "command": "uv",
   "args": [
   "--directory",
   "/path/to/gr-mcp",
   "run",
   "main.py"
   ]
   }
   }

开发

安装开发依赖项并运行测试：
bash
pip install -e ".[dev]"
pytest

项目状态

正在积极开发中。 核心服务器功能已经可用，但 API 和功能仍在不断演进。非常欢迎您的反馈和贡献！