Sota Mcp

io.github.qso-graph由 GitHub 账号 qso-graph 发布v0.4.1更新于 Nov 3, 2026

Summits on the Air MCP server. Summit lookup, spots, alerts, nearby summits.

发布方自己的服务:Sota

概览

AI 生成的概览

面向 Summits on the Air(SOTA)的只读 MCP 服务器,让助手查询实时 spot、激活预告、山峰详情和附近山峰。

可以做什么
  • 获取当前及最近的 SOTA spot,可按时间窗口和协会/模式筛选
  • 列出即将进行的激活预告
  • 按 SOTA 参考编号查询山峰详情
  • 按地理位置查找附近的山峰
  • 查看服务版本与上游 API 规范版本,用于比对部署
适用场景
适合业余无线电爱好者和 SOTA 追逐者或激活者,让助手回答当前有哪些 spot、有哪些激活计划、某地附近有哪些山峰等问题。
运行要求
以 Python 包(sota-mcp)在本地运行,通过 uvx 启动,需要 Python/uv 环境。无需账号或 API 密钥,使用公开的 SOTA API,因此需要网络访问;另提供离线模拟模式用于测试。
安装前请注意
所有工具都是对公开 SOTA 数据的只读查询,不涉及账号、密钥或写入操作。查询内容(包括附近山峰搜索所用的坐标)会发送到公开的 SOTA API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Sota Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

sota-mcp

[PyPI] [MCP Registry]

MCP server for Summits on the Air (SOTA) — live spots, activation alerts, summit info, and nearby summits through any MCP-compatible AI assistant.

Part of the QSO-Graph project. No authentication required — uses the public SOTA API exclusively.

Install

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

Tools

ToolDescription
sota_spotsCurrent and recent spots with time window and association/mode filters
sota_alertsUpcoming scheduled activation alerts
sota_summit_infoSummit details by SOTA reference code
sota_summits_nearFind summits near coordinates (geospatial search)
get_version_infoService version + upstream spec version (fleet identity attestation)

Quick Start

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

Configure your MCP client

sota-mcp works with any MCP-compatible client. Add the server config and restart — tools appear automatically.

Claude Desktop

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

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

Add to .claude/settings.json:

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

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

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

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

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

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

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

Ask questions

"What SOTA spots are active right now?"

"Tell me about summit W7I/SI-001"

"What summits are near Boise, Idaho?"

"Any SOTA alerts for this weekend?"

Testing Without Network

For testing all tools without hitting the SOTA APIs:

bash
SOTA_MCP_MOCK=1 sota-mcp

MCP Inspector

bash
sota-mcp --transport streamable-http --port 8007

Then open the MCP Inspector at http://localhost:8007.

Development

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

License

GPL-3.0-or-later

来源:README.md,提交 2153c87

工具

5

get_version_info

Get Version Info

Get sota-mcp service version and upstream spec version. Returns the running PyPI version of sota-mcp and the SOTA api2 endpoint contract 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.

无需输入参数。

sota_spots

Sota Spots

Get current and recent SOTA spots. Returns live spot feed with summit details.

输入参数modehoursassociation

sota_alerts

Sota Alerts

Get upcoming SOTA activation alerts.

输入参数hoursassociation

sota_summit_info

Sota Summit Info

Get detailed summit information by SOTA reference code.

输入参数summit_code必填

sota_summits_near

Sota Summits Near

Find SOTA summits near a geographic location.

输入参数limitlatitude必填longitude必填radius_km

版本历史

9
  1. v0.4.1最新Oct 29, 2026
  2. v0.2.3Oct 26, 2026
  3. v0.2.1Oct 26, 2026
  4. v0.2.0Oct 12, 2026
  5. v0.1.10Oct 11, 2026
  6. v0.1.9Oct 7, 2026
  7. v0.1.8Oct 6, 2026
  8. v0.1.7Sep 29, 2026
  9. v0.1.1Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Sota 集成