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 分