Pota Mcp

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

Parks on the Air MCP server. Park lookup, activator and hunter stats, live spots.

已驗證STDIO僅桌面位置與生活網頁搜尋與抓取

概覽

AI 產生的概覽

Parks on the Air（POTA）伺服器，讓助理查詢公園資訊、即時啟用點、預定啟用以及啟用者與獵取者統計。

可以做什麼
  • 查詢即時啟用點與即將進行的預定啟用，支援可選篩選條件
  • 依參考編號讀取公園詳情，以及啟用次數、QSO 數量與近期啟用紀錄
  • 查看公園排行榜，以及某個呼號的啟用者與獵取者統計
  • 依州、省或國家列出公園，尋找某地點附近的公園，並找出附近很少被啟用的公園
  • 回報服務版本與上游 POTA API 規格版本
適用情境
適合業餘無線電玩家、POTA 獵取者或啟用者，讓助理回答關於公園、目前啟用點、行程和呼號統計的問題，或規劃附近的啟用地點與一次啟用多個公園的候選。
執行需求
以 Python 套件 pota-mcp 形式在本機執行，透過 uvx 啟動；不需要憑證或環境變數。取得真實資料需要連線至公開的 POTA API。另有模擬模式可供離線測試。
安裝前請注意
僅對公開的 POTA 介面進行唯讀查詢，不涉及驗證、金鑰或寫入操作。查詢內容與呼號會傳送給第三方的 POTA API。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

pota-mcp

[PyPI] [MCP Registry]

MCP server for Parks on the Air (POTA) — live activator spots, park info, activator/hunter stats, and scheduled activations through any MCP-compatible AI assistant.

Part of the qso-graph project. No authentication required — all POTA endpoints are public.

Install

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

Tools

ToolDescription
pota_spotsCurrent activator spots with park/grid enrichment and optional filters
pota_park_infoPark details by reference code (name, grid, type, agencies, website)
pota_park_statsActivation and QSO counts for a park
pota_park_activationsA park's recent activations — who, when, and QSOs by mode
pota_park_leaderboardA park's top activators, activator QSOs and hunter QSOs
pota_user_statsActivator/hunter stats by callsign (callsign, name, activator, attempts, hunter, awards, endorsements; no address or email-derived fields)
pota_scheduledUpcoming scheduled activations, with optional location, park, activator and time-window filters
pota_location_parksAll parks in a state/province/country
pota_nearby_parksFind parks near a point — great for 2-fer planning
pota_rare_parks_nearParks near a point that are rarely or never activated
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

pota-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": {    "pota": {      "command": "uvx",      "args": ["pota-mcp"]    }  }}
Claude Code

Add to .claude/settings.json:

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

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

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

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

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

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

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

Ask questions

"What POTA activations are happening right now?"

"Tell me about park US-0001 — how many activations has it had?"

"What are K4SWL's POTA stats?"

"Show me all parks in Idaho"

"Are there any CW activators on 20m right now?"

"What activations are scheduled for tomorrow?"

Testing Without Network

For testing all tools without hitting the POTA API:

bash
POTA_MCP_MOCK=1 pota-mcp

MCP Inspector

bash
pota-mcp --transport streamable-http --port 8006

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

Development

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

License

GPL-3.0-or-later

來源：README.md，提交 a322bba

工具

11

get_version_info

Get Version Info

Get pota-mcp service version and upstream spec version. Returns the running PyPI version of pota-mcp and the POTA API revision currently 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.

無需輸入參數。

pota_spots

Pota Spots

Get current POTA activator spots. Returns live spot feed with park details, grid squares, and coordinates. All filters are optional — omit to get all active spots.

輸入參數bandmodeprogramlocation

pota_park_info

Pota Park Info

Get detailed park information by POTA reference code.

輸入參數reference必填

pota_park_stats

Pota Park Stats

Get activation and QSO counts for a POTA park.

輸入參數reference必填

pota_park_activations

Pota Park Activations

List recent activations of a POTA park, most recent first. Answers "when was this park last activated?" and "is it often on the air?".

輸入參數countreference必填

pota_park_leaderboard

Pota Park Leaderboard

Top activators and hunters of a POTA park. Three boards: most activations, most QSOs as an activator, most QSOs as a hunter. Each row is a callsign and a count and nothing else.

輸入參數limitreference必填

pota_user_stats

Pota User Stats

Get POTA activator and hunter statistics for a callsign.

輸入參數callsign必填

pota_scheduled

Pota Scheduled

Get upcoming scheduled POTA activations. All filters are optional and combine with AND — omit them all and the whole schedule comes back, as before.

輸入參數locationactivatorreferencewithin_hours

pota_location_parks

Pota Location Parks

List all POTA parks in a state, province, or country.

輸入參數location必填

pota_nearby_parks

Pota Nearby Parks

Find POTA parks near a geographic point. Fetches all parks in the given location and filters by distance. Useful for finding 2-fer candidates near an activation site.

輸入參數limitlatitude必填location必填longitude必填radius_km

pota_rare_parks_near

Pota Rare Parks Near

Find the least-activated POTA parks near a point. Answers "which parks near me have never, or rarely, been activated?" — for an activator looking for something unworked, or a hunter looking for a rare one. Least activated first, nearest first among equals.

輸入參數limitlatitude必填location必填longitude必填radius_km

版本歷史

11
  1. v0.7.1最新Oct 29, 2026
  2. v0.6.0Oct 26, 2026
  3. v0.4.3Oct 26, 2026
  4. v0.4.1Oct 26, 2026
  5. v0.4.0Oct 12, 2026
  6. v0.3.0Oct 11, 2026
  7. v0.2.6Oct 9, 2026
  8. v0.2.5Oct 7, 2026
  9. v0.2.4Oct 6, 2026
  10. v0.2.3Sep 29, 2026
  11. v0.1.1Sep 16, 2026

評分

已滿足適用檢查項的 90%

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

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

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

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