Pota Mcp

pota-mcp

适用于 Parks on the Air (POTA) 的 MCP 服务，可通过任何兼容 MCP 的 AI 助手查询实时激活者呼叫信息、园区信息、激活者／猎手统计数据和计划激活活动。

这是 qso-graph 项目的一部分。无需身份验证——所有 POTA 端点均为公开端点。

安装

uvx pota-mcp            # run it; nothing to install

工具

工具	描述
pota_spots	当前激活者呼叫信息，附带园区／网格信息，并支持可选筛选条件
pota_park_info	根据参考代码查询园区详情（名称、网格、类型、机构、网站）
pota_park_stats	园区的激活和 QSO 数量
pota_park_activations	园区最近的激活活动——人员、时间以及按模式统计的 QSO 数量
pota_park_leaderboard	园区排名靠前的激活者、激活者 QSO 和猎手 QSO
pota_user_stats	根据呼号查询激活者／猎手统计数据（呼号、姓名、激活者、尝试次数、猎手、奖项、认可；不含地址或从电子邮件推导出的字段）
pota_scheduled	即将进行的计划激活活动，可选按位置、园区、激活者和时间范围筛选
pota_location_parks	查询某州／省／国家的所有园区
pota_nearby_parks	查找某个点附近的园区——非常适合规划双园区活动
pota_rare_parks_near	查找某个点附近很少或从未被激活的园区
get_version_info	服务版本和上游规范版本（服务集群身份证明）

快速开始

无需凭据——只需安装并配置 MCP 客户端。

配置 MCP 客户端

pota-mcp 适用于任何兼容 MCP 的客户端。添加服务配置并重启，工具便会自动显示。

Claude Desktop

将配置添加到 claude_desktop_config.json（macOS 上位于 ~/Library/Application Support/Claude/，Windows 上位于 %APPDATA%\Claude\）：

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

Claude Code

添加到 .claude/settings.json：

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

ChatGPT Desktop

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

Cursor

添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

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

VS Code / GitHub Copilot

添加到工作区中的 .vscode/mcp.json：

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

Gemini CLI

添加到 ~/.gemini/settings.json（全局）或 .gemini/settings.json（项目级）：

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

提出问题

“现在有哪些 POTA 激活活动正在进行？”

“介绍一下 US-0001 园区——它有过多少次激活？”

“K4SWL 的 POTA 统计数据是什么？”

“显示 Idaho 的所有园区”

“现在 20m 频段上有 CW 激活者吗？”

“明天有哪些计划激活活动？”

离线测试

无需调用 POTA API 即可测试所有工具：

POTA_MCP_MOCK=1 pota-mcp

MCP Inspector

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

然后在 http://localhost:8006 打开 MCP Inspector。

开发

git clone https://github.com/qso-graph/pota-mcp.git
cd pota-mcp
uv sync --group dev
uv run pytest

许可证

GPL-3.0-or-later