Wspr Mcp

wspr-mcp

适用于 WSPR（弱信号传播报告）的 MCP 服务，可通过任何兼容 MCP 的 AI 助手查询信标数据，包括实时报告、频段活动、热门信标、传播路径、SNR 趋势等。

数据来自 wspr.live（约 27 亿条报告，2008 年至今）。这是 qso-graph 项目的一部分。无需身份验证——所有数据均为公开数据。

安装

uvx wspr-mcp            # run it; nothing to install

工具

工具	描述	关键参数
wspr_spots	支持灵活筛选的近期 WSPR 报告	呼号、频段、小时数、网格、最小/最大 SNR、最小距离
wspr_band_activity	各频段的报告数、台站数、距离和 SNR	小时数
wspr_top_beacons	按报告数或最大距离排名的顶级发射机	频段、小时数、sort_by（spots/distance）、limit
wspr_top_spotters	按报告数或最大距离排名的顶级接收机	频段、小时数、sort_by（spots/distance）、limit
wspr_propagation	两个位置之间的传播情况——端点数据稀疏时会自动扩大到场级代理范围	tx、rx、频段、小时数
wspr_grid_activity	Maidenhead 网格内所有 WSPR 收发活动	网格（2 或 4 个字符）、频段、小时数
wspr_longest_paths	指定时间范围内距离最远的 WSPR 路径	频段、小时数、最小距离、limit
wspr_snr_trend	特定路径随时间变化的每小时 SNR 趋势	tx、rx、频段、小时数
get_version_info	服务版本及上游规范版本（集群身份声明）	—

什么是 WSPR？

WSPR 信标以极低功率（通常为 200 mW 至 5 W）发送经过编码的 2 分钟信号。每条解码后的报告都证明两个位置之间在特定频段上存在传播路径。全球数千个信标全天候发送信号，WSPR 因而能够持续、自动地监测所有 HF 频段的传播情况。

友邻政策

wspr.live 是一项由志愿者运营的服务，会将 wsprnet.org 的所有数据同步到公共 ClickHouse 数据库。我们认真履行友邻责任：

措施	详情
速率限制	请求间隔 3 秒（最多 20 次请求/分钟）
断路器	连续失败 3 次后打开；采用指数退避，最长 5 分钟。避免对不稳定的服务持续施压。
限定时间范围的查询	每个查询都按时间筛选（最长 72 小时）。不会进行不受限的全表扫描。
频段筛选	用户提供频段时，查询都会按频段筛选——这样可以高效利用 wspr.live 的索引。
列选择	每个工具只 SELECT 所需的列（每次查询 8–10 列），绝不使用 SELECT *。
结果限制	所有查询均限制结果数量（200 条报告、50 条排行榜记录）。
响应缓存	每个工具的 TTL 为 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 和布韦岛（JD15）之间有 WSPR 路径吗？” （如果没有完全匹配的结果，则自动扩大到 DN↔JD）

“网格方格 JN48 的情况如何？”

“K9AN 和 G8JNJ 在 20m 波段上的信噪比（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