Wspr Mcp

io.github.qso-graph由 GitHub 帳號 qso-graph 發布v0.6.1更新於 Nov 3, 2026

WSPR beacon analytics MCP server. Band openings, path analysis, solar correlation.

已驗證STDIO僅桌面位置與生活資料與分析

概覽

AI 產生的概覽

唯讀的 WSPR 信標資料 MCP 伺服器，以 wspr.live 為資料來源，讓助理查詢即時 spots、波段開通狀況、傳播路徑與 SNR 趨勢。

可以做什麼
  • 依呼號、波段、網格、SNR 與距離篩選查詢近期 WSPR spots
  • 彙整各波段的活躍度，包含 spot 數、電台數、距離與 SNR
  • 依 spot 數或最遠距離排序頂尖信標台與頂尖接收台
  • 分析兩個呼號或網格之間的傳播，並列出時間範圍內最長的路徑
  • 檢視某個 Maidenhead 網格方格的進出活動，以及某條路徑的逐小時 SNR 趨勢
  • 回報服務版本與上游 schema 版本
適用情境
適合業餘無線電玩家與傳播研究者，讓助理解讀 HF 波段狀況、比較電台或網格之間的路徑，並觀察某個波段隨時間的開通與關閉。
執行需求
以 Python 套件形式在本機執行，透過 uvx 啟動（需 Python 工具鏈）。不需帳號、API 金鑰或環境變數。需要連線至 wspr.live 公開 ClickHouse 服務；另有供離線測試的 mock 模式。
安裝前請注意
資料全部公開，伺服器為唯讀，不涉及憑證。查詢會送往志工維運的第三方服務，因此你詢問的呼號、網格與時間範圍會傳送出去；伺服器自我限制為每分鐘 20 次請求，查詢時間範圍上限 72 小時。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Wspr Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

wspr-mcp

[PyPI] [MCP Registry]

MCP server for WSPR (Weak Signal Propagation Reporter) beacon data — live spots, band activity, top beacons, propagation paths, SNR trends, and more through any MCP-compatible AI assistant.

Data from wspr.live (~2.7 billion spots, 2008-present). Part of the qso-graph project. No authentication required — all public data.

Install

bash
uvx wspr-mcp            # run it; nothing to install

Tools

ToolDescriptionKey Parameters
wspr_spotsRecent WSPR spots with flexible filteringcallsign, band, hours, grid, min/max SNR, min distance
wspr_band_activityPer-band spot counts, station counts, distances, and SNRhours
wspr_top_beaconsTop transmitters ranked by spot count or max distanceband, hours, sort_by (spots/distance), limit
wspr_top_spottersTop receivers ranked by spot count or max distanceband, hours, sort_by (spots/distance), limit
wspr_propagationPropagation between two locations — auto-widens to field-level proxy for sparse endpointstx, rx, band, hours
wspr_grid_activityAll WSPR activity in/out of a Maidenhead grid squaregrid (2 or 4 char), band, hours
wspr_longest_pathsLongest distance WSPR paths in a time windowband, hours, min_distance, limit
wspr_snr_trendHourly SNR trend for a specific path over timetx, rx, band, hours
get_version_infoService version + upstream spec version (fleet identity attestation)—

What is WSPR?

WSPR beacons transmit a 2-minute encoded signal at very low power (typically 200 mW to 5 W). Each decoded spot proves a propagation path exists between two locations on a specific band. With thousands of beacons worldwide transmitting 24/7, WSPR provides continuous, automated propagation monitoring across all HF bands.

Good Neighbour Policy

wspr.live is a volunteer-run service that mirrors all wsprnet.org data into a public ClickHouse database. We take our responsibility as a good neighbour seriously:

MeasureDetail
Rate limiting3 seconds between requests (20 req/min max)
Circuit breakerOpens after 3 consecutive failures; exponential backoff up to 5 minutes. Prevents hammering a struggling service.
Time-bounded queriesEvery query filters by time (max 72 hours). No unbounded full-table scans.
Band filteringQueries filter by band whenever the user provides one — this hits wspr.live's indexes efficiently.
Column selectionWe SELECT only the columns each tool needs (8-10 per query), never SELECT *.
Result limitsAll queries cap results (200 spots, 50 leaderboard entries).
Response caching2-10 minute TTL per tool. Identical queries within the window hit local cache with zero network traffic.
Request timeout20-second timeout — we don't hold connections open on a shared service.
User-Agent headerEvery request identifies itself as wspr-mcp/{version} so the operators can reach us if needed.

If wspr.live is down or overloaded, the circuit breaker backs off automatically. We don't retry in a tight loop.

Quick Start

No credentials needed — just install and configure your MCP client.

Configure your MCP client

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

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

Add to .claude/settings.json:

json
{  "mcpServers": {    "wspr": {      "command": "uvx",      "args": ["wspr-mcp"]    }  }}
ChatGPT Desktop
json
{  "mcpServers": {    "wspr": {      "command": "uvx",      "args": ["wspr-mcp"]    }  }}
Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

json
{  "mcpServers": {    "wspr": {      "command": "uvx",      "args": ["wspr-mcp"]    }  }}
VS Code / GitHub Copilot

Add to .vscode/mcp.json in your workspace:

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

Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):

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

Ask questions

"Show me recent WSPR spots on 20m"

"What bands are open right now?"

"Who are the top WSPR beacons on 20m today?"

"What are the longest WSPR paths in the last 24 hours?"

"Is there propagation between Idaho (DN13) and central Europe (JN48)?"

"Any WSPR paths between DN13 and Bouvet (JD15)?" (auto-widens to DN↔JD if no exact match)

"What's happening in grid square JN48?"

"How's the SNR trending between K9AN and G8JNJ on 20m?"

"Who are the best WSPR receivers sorted by distance?"

Testing Without Network

bash
WSPR_MCP_MOCK=1 wspr-mcp

MCP Inspector

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

Development

bash
git clone https://github.com/qso-graph/wspr-mcp.gitcd wspr-mcpuv sync --group devuv run pytest

License

GPL-3.0-or-later

來源：README.md，提交 7a34887

工具

9

get_version_info

Get Version Info

Get wspr-mcp service version and upstream spec version. Returns the running PyPI version of wspr-mcp and the wspr.live ClickHouse schema revision in use. Use this to confirm fleet alignment across MCP deployments — agents can compare service_version and spec_version across servers to detect drift without going outside the MCP protocol.

無需輸入參數。

wspr_spots

Wspr Spots

Get recent WSPR spots. WSPR beacons transmit every 2 minutes on precise frequencies. Each spot is a 2-minute integration proving a propagation path exists.

輸入參數bandgridhourslimitmax_snrmin_snrcallsignmin_distance

wspr_band_activity

Wspr Band Activity

Get per-band WSPR activity summary. Shows spot counts, TX/RX station counts, average and max distance, and average SNR for each band. The best indicator of which bands are open right now.

輸入參數hours

wspr_top_beacons

Wspr Top Beacons

Get top WSPR transmitters ranked by spot count or max distance. Shows the most active or most far-reaching WSPR beacon operators. Useful for finding who's putting out a big signal on a band.

輸入參數bandhourslimitsort_by

wspr_top_spotters

Wspr Top Spotters

Get top WSPR receivers ranked by spot count or max distance. Shows the most prolific or most sensitive WSPR receiving stations. Useful for finding good receivers to monitor for propagation.

輸入參數bandhourslimitsort_by

wspr_propagation

Wspr Propagation

Get WSPR-derived propagation between two locations. Shows which bands have been open between two endpoints, with spot counts, SNR statistics, and hours of opening. Accepts callsigns or grid squares (or a mix). Searches both directions automatically.

輸入參數rx必填tx必填bandhours

wspr_grid_activity

Wspr Grid Activity

Get all WSPR activity in or out of a Maidenhead grid square. Shows summary stats and recent spots for a geographic area. Use 2-character grid (e.g., DN) for a wide area or 4-character (e.g., DN13) for a specific region.

輸入參數bandgrid必填hourslimit

wspr_longest_paths

Wspr Longest Paths

Get the longest WSPR paths in the given time window. WSPR's precise timing and low power make it the gold standard for detecting marginal propagation. Long paths here prove the band is open.

輸入參數bandhourslimitmin_distance

wspr_snr_trend

Wspr Snr Trend

Get SNR trend over time for a specific WSPR path. Shows hourly SNR buckets for a path between two endpoints. Useful for seeing when a band opens and closes on a specific path, and how signal strength varies over time.

輸入參數rx必填tx必填bandhours

版本歷史

9
  1. v0.6.1最新Oct 29, 2026
  2. v0.4.3Oct 26, 2026
  3. v0.4.1Oct 26, 2026
  4. v0.4.0Oct 12, 2026
  5. v0.3.6Oct 11, 2026
  6. v0.3.5Oct 7, 2026
  7. v0.3.4Oct 6, 2026
  8. v0.3.3Sep 29, 2026
  9. v0.1.1Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分