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	地点の近くにある公園を検索します。2 フェルの計画に最適です
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