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 整合