wspr mcp
MCP服务器 WSPR （弱信号传播报告器）信标数据——通过任何兼容MCP的AI助手，实时点、频带活动、顶部信标、传播路径、信噪比趋势等。
数据来自 wspr.live （约27亿点，2008年至今）。部分 qso图 项目。 不要求进行验证 --所有公共数据。
安装
pip install wspr-mcp工具
| 工具 | 说明 | 关键参数 |
|---|---|---|
wspr_spots | 最近使用灵活滤波的WSPR点 | 呼号、频带、小时、网格、最小/最大信噪比、最小距离 |
wspr_band_activity | 每频带点计数、站计数、距离和信噪比 | 小时 |
wspr_top_beacons | 按点数或最大距离 | 频段、小时、排序（点数/距离）、限制排名的顶级发射机 |
wspr_top_spotters | 按点数或最大距离 | 波段、小时、排序（点数/距离）、限制排名的顶级接收器 |
wspr_propagation | 两个位置之间的传播——自动扩展到稀疏端点的字段级代理 | tx、rx、band、hours |
wspr_grid_activity | Maidenhead方格内/外的所有WSPR活动 | 方格（2或4个字符）、带、小时 |
wspr_longest_paths | 时间窗口内最长距离WSPR路径 | 带、小时、最小距离、限制 |
wspr_snr_trend | 特定路径随时间变化的每小时信噪比趋势 | 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的索引。 |
| 列选择 | 我们只选择每个工具需要的列（每个查询8-10个），从不 SELECT *. |
| 结果限制 | 所有查询的结果都有上限（200个点，50个排行榜条目）。 |
| 响应缓存 | 每个工具2-10分钟TTL。窗口内的相同查询会以零网络流量命中本地缓存。 |
| 请求超时 | 20秒超时——我们不会在共享服务上保持连接打开。 |
| 用户代理标头 | 每个请求都标识为 wspr-mcp/{version} 因此，如果需要，操作员可以联系我们。 |
如果wspr.live停机或过载，断路器会自动后退。我们不会在紧循环中重试。
快速开始
无需凭据，只需安装和配置MCP客户端即可。
配置您的MCP客户端
克劳德桌面版
添加 claude_desktop_config.json (~/Library/Application Support/Claude/ 在macOS上， %APPDATA%\Claude\ 在Windows上）：
{
"mcpServers": {
"wspr": {
"command": "wspr-mcp"
}
}
}克劳德代码
添加 .claude/settings.json:
{
"mcpServers": {
"wspr": {
"command": "wspr-mcp"
}
}
}ChatGPT桌面
{
"mcpServers": {
"wspr": {
"command": "wspr-mcp"
}
}
}光标
添加 .cursor/mcp.json （项目层面）或 ~/.cursor/mcp.json （全球）：
{
"mcpServers": {
"wspr": {
"command": "wspr-mcp"
}
}
}VS代码/GitHub副本
添加 .vscode/mcp.json 在您的工作空间中：
{
"servers": {
"wspr": {
"command": "wspr-mcp"
}
}
}Gemini CLI
添加 ~/.gemini/settings.json （全球）或 .gemini/settings.json （项目）：
{
"mcpServers": {
"wspr": {
"command": "wspr-mcp"
}
}
}提问
“显示20米上最近的WSPR广告”
“现在有哪些乐队开放？”
“谁是当今20米高空的顶级WSPR信标？”
“过去24小时内最长的WSPR路径是什么？”
爱达荷州（DN13）和中欧（JN48）之间有传播吗
“DN13和Bouvet（JD15）之间有任何WSPR路径吗？” *（自动扩展到DN↔JD（如果没有完全匹配）*
“JN48网格中发生了什么？”
“K9AN和G8JNJ在20米距离上的信噪比趋势如何？”
“按距离排序，谁是最好的WSPR接收器？”
无网络测试
WSPR_MCP_MOCK=1 wspr-mcpMCP检查员
wspr-mcp --transport streamable-http --port 8009发展
git clone https://github.com/qso-graph/wspr-mcp.git
cd wspr-mcp
pip install -e .许可证
GPL-3.0或更高版本