Wspr Mcp

wspr-mcp

WSPR（Weak Signal Propagation Reporter）ビーコンデータ用の MCP サーバーです。ライブスポット、バンドのアクティビティ、上位ビーコン、伝搬経路、SNR の推移などを、MCP 対応の AI アシスタントから利用できます。

データは wspr.live（約27億件のスポット、2008年から現在まで）から取得しています。qso-graph プロジェクトの一部です。認証は不要です。すべて公開データです。

インストール

uvx wspr-mcp            # run it; nothing to install

ツール

ツール	説明	主なパラメーター
wspr_spots	柔軟な条件指定で最近の WSPR スポットを取得	callsign、band、hours、grid、最小／最大 SNR、最小距離
wspr_band_activity	バンドごとのスポット数、局数、距離、SNR	hours
wspr_top_beacons	スポット数または最大距離で順位付けした上位送信機	band、hours、sort_by（spots/distance）、limit
wspr_top_spotters	スポット数または最大距離で順位付けした上位受信機	band、hours、sort_by（spots/distance）、limit
wspr_propagation	2地点間の伝搬。端点のデータが少ない場合は、フィールドレベルのプロキシへ自動的に範囲を拡大	tx、rx、band、hours
wspr_grid_activity	Maidenhead グリッドスクエアへの入出力を含む、すべての WSPR アクティビティ	grid（2文字または4文字）、band、hours
wspr_longest_paths	指定期間内で距離が最長の WSPR 経路	band、hours、min_distance、limit
wspr_snr_trend	時間経過に伴う特定経路の時間ごとの SNR 推移	tx、rx、band、hours
get_version_info	サービスのバージョンと上流仕様のバージョン（フリート識別の証明）	—

WSPR とは？

WSPR ビーコンは、非常に低い出力（通常200 mW～5 W）で、2分間のエンコードされた信号を送信します。デコードされた各スポットは、特定のバンド上で2地点間に伝搬経路が存在することを示します。世界中の何千ものビーコンが24時間365日送信しているため、WSPR はすべての HF バンドにわたる継続的かつ自動化された伝搬モニタリングを実現します。

グッドネイバーポリシー

wspr.live はボランティアによって運営されており、wsprnet.org のすべてのデータを公開 ClickHouse データベースに複製しています。私たちは、隣人としての責任を真摯に受け止めています。

対策	詳細
レート制限	リクエスト間隔は3秒（最大20リクエスト／分）
サーキットブレーカー	3回連続で失敗すると開き、最大5分まで指数バックオフします。応答が不安定なサービスへの過剰なリクエストを防ぎます。
時間範囲を限定したクエリ	すべてのクエリで時間を指定します（最大72時間）。テーブル全体を無制限にスキャンすることはありません。
バンドによる絞り込み	ユーザーがバンドを指定した場合、クエリをそのバンドで絞り込みます。これにより wspr.live のインデックスを効率的に利用できます。
列の選択	各ツールで必要な列（クエリごとに8～10列）のみを SELECT し、SELECT * は使用しません。
結果数の上限	すべてのクエリで結果数を制限します（スポットは200件、ランキングは50件）。
レスポンスのキャッシュ	ツールごとに有効期間は2～10分です。この期間内の同一クエリにはローカルキャッシュを使用し、ネットワーク通信は発生しません。
リクエストのタイムアウト	タイムアウトは20秒です。共有サービスへの接続を長時間維持しません。
User-Agent ヘッダー	すべてのリクエストで wspr-mcp/{version} として識別するため、必要に応じて運営者が連絡できます。

wspr.live が停止中または過負荷の場合、サーキットブレーカーが自動的にバックオフします。短い間隔でリトライを繰り返すことはありません。

クイックスタート

認証情報は不要です。インストールして MCP クライアントを設定するだけです。

MCP クライアントを設定する

Claude Desktop

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

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

Claude Code

.claude/settings.json に追加します：

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

ChatGPT Desktop

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

Cursor

.cursor/mcp.json（プロジェクトレベル）または ~/.cursor/mcp.json（グローバル）に追加します：

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

VS Code / GitHub Copilot

ワークスペースの .vscode/mcp.json に追加します：

{
  "servers": {
    "wspr": {
      "command": "uvx",
      "args": ["wspr-mcp"]
    }
  }
}

Gemini CLI

~/.gemini/settings.json（グローバル）または .gemini/settings.json（プロジェクト）に追加します：

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

質問する

「20mで最近のWSPRスポットを表示してください」

「現在、どのバンドが開いていますか？」

「今日、20mで上位のWSPRビーコンはどれですか？」

「過去24時間で最長のWSPRパスはどれですか？」

「アイダホ（DN13）と中央ヨーロッパ（JN48）間に伝搬はありますか？」

「DN13とBouvet（JD15）間のWSPRパスはありますか？」（完全一致が見つからない場合は、自動的にDN↔JDまで範囲を広げます）

「グリッドスクエアJN48では何が起きていますか？」

「20mでK9ANとG8JNJ間のSNRはどのように推移していますか？」

「距離順に並べた、最良のWSPR受信局を教えてください」

ネットワークなしでのテスト

WSPR_MCP_MOCK=1 wspr-mcp

MCP Inspector

wspr-mcp --transport streamable-http --port 8009

開発

git clone https://github.com/qso-graph/wspr-mcp.git
cd wspr-mcp
uv sync --group dev
uv run pytest

ライセンス

GPL-3.0-or-later