GNU Radio MCP Server (gr-mcp)

gr-mcp は、GNU Radioのフローグラフ操作をAIアシスタントや自動化クライアント向けのツールとして公開するMCPサーバーです。FastMCPに基づいて構築されており、SDRワークフローのプログラムによる生成、編集、検証、エクスポートを目的としています。

提供機能

• 利用可能なGNU Radioブロックの検出

• プログラムによるブロックの作成と削除

• ブロックパラメータの読み取り/書き込み操作

• ブロック間の接続と切断

• フローグラフの検証とエラー検査

• フローグラフの .grc 形式での保存

Related MCP server: GR-MCP

要件

• Python >=3.13

• GNU Radio がインストールされ、Pythonから利用可能であること（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

GNU Radioは通常システムレベルのPythonパッケージとしてインストールされるため、--system-site-packages フラグが必要です。

MCPクライアントでの実行

MCPクライアントの設定（CursorやClaude Desktopなど）に gr-mcp を追加します:

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

開発

開発用依存関係をインストールし、テストを実行します:

pip install -e ".[dev]"
pytest

プロジェクトのステータス

本プロジェクトは現在活発に開発中です。コア機能は利用可能ですが、サーバーの成熟に伴いインターフェースが変更される可能性があります。