jt-mcp

jt-mcp

AI アプリに、WSJT-X が何を受信しているか尋ねましょう。 WSJT-X は動作状況とすべてのデコード結果を UDP サーバーアドレスに送信します。jt-mcp はそこで待ち受け、誰が CQ を出しているか、どのような CQ なのか（DX、POTA、コンテスト、地域）、誰がどの程度の強さで受信されたか、WSJT-X の受信周波数、最近のデコード結果、WSPR スポットについて回答します。

常に読み取り専用です。 jt-mcp は WSJT-X にメッセージを送信しないため、呼び出しに応答したり、送信機のキーを操作したり、設定を変更したりできません。書き込み、PTT、送信制御は一切ありません。これは初期バージョンの制限ではなく、恒久的な制約です。テストではソースコードに対してこの点を検証しています。

WSJT-X を最優先し、プロトコルの定義は WSJT-X に従います。 UDP メッセージの定義は WSJT-X プロジェクトの Network/NetworkMessage.hpp に基づいており、WSJT-X が示すスキーマを使用します。定義を所有するプロジェクトこそが、その定義の権威だからです。コードはqso-graph-libのもので、qso-graph-simが WSJT-X のメッセージを再生する際にも使われています。JTDX、WSJT-Z、MSHV は、これらの定義に沿って動作する範囲でサポートされます。沿わない部分は、ここでは実装していません。独自 API を持つ JS8Call も、WSJT-X に従います。

このサーバーは、2026-10-29 まで js8call-mcp という名称でした。qso-graphプロジェクトの一部です。

インストール

uvx jt-mcp            # run it; nothing to install

WSJT-X のセットアップ

WSJT-X で、File, Settings, Reporting, UDP Server を開き、127.0.0.1、ポート 2237（WSJT-X のデフォルト）を設定します。WSJT-X が同じ PC で動作している場合、jt-mcp に必要なのはこれだけです。

UDP ポートで待ち受けられるプログラムは 1 つだけです。GridTracker、JTAlert、その他のログ記録ソフトがすでに 2237 で待ち受けている場合は、jt-mcp に別のポート（--udp-port）を指定し、WSJT-X にそのポートを設定してください。

ツール

ツール	回答する内容
jt_cq	誰が CQ を出しているか、その種類（通常、DX、アクティビティ（POTA、SOTA、WWFF、IOTA）、コンテスト（TEST、FD、RU、WW）、地域（NA、EU、...）、または周波数（CQ 290））。局ごとの最新情報
jt_status	各 WSJT-X の動作状況：ダイヤル周波数とバンド、モード、DX コールサインとグリッド、Tx が有効か送信中か、自局のコールサインとグリッド
jt_decodes	最近のデコード結果。それぞれの内容（誰が誰を呼んでいるか、グリッド、レポート、交信終了の挨拶）を読み取ります。コールサイン、CQ のみ、SNR、バンドで絞り込み可能
jt_heard	受信した局：受信回数、最後の SNR、最後のグリッド、モード、バンド
jt_wspr	WSJT-X がデコードした WSPR スポット：コールサイン、グリッド、電力、SNR、ドリフト
jt_diagnostics	リスナーの情報：待ち受け先、送信が許可されている相手、受信した内容、破棄された内容とその送信元、各 WSJT-X のバージョン
get_version_info	サービスのバージョンと状態

時刻は UTC です。複数の WSJT-X インスタンス（2 台の無線機、2 つのバンド）は、それぞれが送信する ID（WSJT-X - FT-991A など）で区別されます。

回答できる質問

「今、20 m で POTA の CQ を出している局は？」

「過去 10 分間に DX 局が CQ を出していましたか？強い順に教えて」

「W9XYZ は受信されましたか？信号の強さは？」

「WSJT-X の受信周波数は何で、Tx は有効になっていますか？」

「何も表示されないのはなぜですか？」— jt_diagnostics

MCP クライアントの設定

jt-mcp は MCP 互換の任意のクライアントで動作します。サーバーを追加し、クライアントを再起動してください。

Claude Desktop

claude_desktop_config.json（macOS では ~/Library/Application Support/Claude/、Windows では %APPDATA%\Claude\）に追加します。

{
  "mcpServers": {
    "jt": {
      "command": "uvx",
      "args": ["jt-mcp"]
    }
  }
}

Claude Code

claude mcp add jt -- uvx jt-mcp

ChatGPT Desktop

Settings > Apps & Connectors から設定するか、エージェント定義で、上記と同じ command と args を指定します。

別の PC 上の WSJT-X

デフォルトでは、jt-mcp は 127.0.0.1 で待ち受けます。これはこの PC のみです。別の PC 上の WSJT-X を使用するには、--bind でこの PC のアドレスを 1 つ指定し、送信を許可する各 PC を --allow で指定します。

"args": ["jt-mcp", "--bind", "192.168.1.50", "--allow", "192.168.1.40"]

さらに、WSJT-X の UDP Server を 192.168.1.50 に設定します。すべてのインターフェースで同時に待ち受ける設定（0.0.0.0）は拒否され、ネットワークアドレスを指定する場合は --allow が必須です。また、名前は指定できず、IP アドレスのみ指定できます。それ以外の送信元からのデータグラムは読み取らずに破棄され、その数がカウントされます。jt_diagnostics では、その数とアドレスを確認できます。

許可リストで防げないこと。 許可リストによって、ほかのマシンからの通信を遮断できます。ただし、送信者を証明するものではありません。同じネットワーク上のどの機器でも、UDP 送信元アドレスを偽装できます。それを制限しているのは、jt-mcp が読み取り専用である点です。そのため、偽装されたデータグラムによって WSJT-X の動作を誤認させることはできますが、何かを実行させることはできません。

オプション

jt-mcp [--bind ADDR] [--allow ADDR ...] [--udp-port N]
       [--transport stdio|streamable-http] [--port N] [--version] [--help]

オプション	デフォルト
--bind ADDR	127.0.0.1	WSJT-X の待ち受けアドレス
--allow ADDR	この PC	送信を許可する PC。繰り返し指定可能。ネットワークの --bind を指定する場合は必須
--udp-port N	2237	WSJT-X の UDP Server ポート
--transport	stdio	streamable-http は 127.0.0.1 のみで待ち受けます
--port N	8031	streamable-http のポート

ライセンス

GPL-3.0-or-later。LICENSE を参照してください。