GR-MCP: A gnuradio MCP Server

Marconi 🤖

        o)))
        |
    .-------.
    | o   o |
    |   v   |
    '-------'

    Hi! I'm Marco.

Claude Code 向けの LLM 駆動型 RF です。電波に載せたい内容を伝えると、スペクトラムを調査し、受信機を構築して実行し、信号を確認します。さらに、再現可能な RF プロジェクト（SigMF キャプチャ、YAML パイプライン、自分で所有できる .grc フローグラフ）を残します。

開発初期段階です。v1.0 はシミュレーション専用で、ハードウェアにはまだ対応していません。ROADMAP.md を参照してください。

以前は GNURadio/GR-MCP として知られていました。

必要条件

• uv と Python ≥ 3.13
• システム全体にインストールされた GNU Radio 3.10 以降（conda-forge、ディストリビューションのパッケージマネージャー、または Homebrew）。パイプラインの実行とシミュレーションに必要です。既存の IQ ファイルの分析には不要です。

インストール

Claude Code で次を実行します。

/plugin marketplace add yoelbassin/gr-mcp
/plugin install marconi

これで完了です。初回使用時に uv が MCP サーバーを起動し、スキルを読み込みます。それ以外の設定は必要ありません。

使用方法

自然な言葉で尋ねてください。

「100.3 MHz の FM 局をシミュレートして、受信機を作ってください。」

「このキャプチャ mystery.wav を使って、電波に何があるか調査し、最も強い搬送波をデコードしてください。」

適切なスキルを選び、ワークフローを最初から最後まで進めます。

• survey-spectrum — 何が存在するかを調査します（PSD、信号検出、スペクトログラム）
• simulate-scene — 説明からシミュレートされたデバイスを登録します
• build-receiver — チャネル化、復調、検証、実行、確認、保存を行います
• debug-no-signal — 受信機から何も出力されない場合に、問題箇所を特定します
• tx-experiment — シミュレーションで送信後に受信する閉ループ実験を行います
• escape-hatch — 適合するツールがない場合に、Python ライブラリを直接使用します

生成物はサーバーの作業ディレクトリ内の artifacts/ に保存されます。別の場所に保存するには MARCONI_WORKSPACE を設定してください。

ライセンス

GPL-3.0-or-later。