itu-zones-mcp

itu-zones-mcp

出典：IARU の HF Managers Handbook 第 9.8 章「Definition of ITU-Zones when used by radio amateurs」（IARU Region 1、v8.2。章のページの日付は 2000 年 11 月です）。アマチュア無線で使用するゾーンの境界線は、IARU Region 1 の推奨 REC/99/LH/C4.2 に基づいて記載されています。このリストは、ITU の CIRAF ゾーンをもとに G3HTA が作成し、IARU の 3 地域すべてによって承認されました。90 の ITU ゾーンは IARU のものです。このパッケージは同章の情報を提供し、それぞれの出典ページとゾーンを示すとともに、ハンドブックへのリンクを掲載しています。GPL-3.0 ライセンスの対象はコードであり、IARU のデータではありません。

照合対象：AD1C の国別ファイル（Jim Reisert、AD1C）、ADIF 3.1.7 の行政区画ゾーン、ARRL の DXCC リスト。テストでは、情報を検証するために AD1C と ARRL のサイトから各ファイルを取得します。いずれのファイルもここには含まれていません。相違がある場合は、情報の所有者のリストを優先します（docs/TRANSCRIPTION.md を参照）。

アマチュア無線向けに IARU が公開している ITU ゾーン用の MCP サーバーです。IARU Region 1 HF Managers Handbook（v8.2）の第 9.8 章「Definition of ITU-Zones when used by radio amateurs」にある 90 のゾーンを提供します。これらのゾーンは、IARU HF Championship や ITU ゾーンのアワードで使用されています。各ゾーンのプレフィックスは、ADIF 独自の DXCC コードおよび行政区画コードで示し、エリアが境界線によって分割されている場合は IARU 独自の表現を掲載しています。

qso-graph プロジェクトの一部です。ネットワーク接続も認証も不要です。所有者のリストに記載された情報はパッケージに含まれており、すべての回答で出典を明示します。

インストール

uvx itu-zones-mcp            # run it; nothing to install

ツール

ツール	説明	主なパラメーター
itu_zones_lookup	1 つのゾーンについて、IARU が記載するすべてのプレフィックス、行政区画、境界と出典を表示	code
itu_zones_codes_for	ADIF の DXCC エンティティ、またはその行政区画を含むゾーンを表示	dxcc, subdivision
itu_zones_search	プレフィックスまたは説明文でゾーンを検索	text, limit
itu_zones_valid_on	指定した日にゾーンが有効だったかを確認（ITU ゾーンに有効期間はありません）	code, on_date
itu_zones_source_info	所有者、版、利用条件、所有者のファイルの URL と SHA-256	—
get_version_info	サービスのバージョンと、提供する所有者の版（フリートの識別情報の証明）	—

クイックスタート

認証情報は不要です。MCP クライアントをインストールして設定するだけです。

MCP クライアントを設定する

itu-zones-mcp は MCP 対応クライアントであればどれでも使用できます。サーバー設定を追加して再起動すると、ツールが自動的に表示されます。

Claude Desktop

claude_desktop_config.json（macOS では ~/Library/Application Support/Claude/、Windows では %APPDATA%\Claude\）に追加します。

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

Claude Code

.claude/settings.json に追加します。

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

ChatGPT Desktop

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

Cursor

.cursor/mcp.json（プロジェクトレベル）または ~/.cursor/mcp.json（グローバル）に追加します。

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

VS Code / GitHub Copilot

ワークスペースの .vscode/mcp.json に追加します。

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

Gemini CLI

~/.gemini/settings.json（グローバル）または .gemini/settings.json（プロジェクト）に追加します。

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

質問する

「アリゾナ州はどの ITU ゾーンにありますか？」

「ITU ゾーン 75 はどの地域をカバーしていますか？」

「南極大陸はどの ITU ゾーンにまたがっていますか？」

MCP Inspector

itu-zones-mcp --transport streamable-http --port 8017

次に、http://localhost:8017 で MCP Inspector を開きます。

開発

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

scripts/fetch_published.py は所有者の文書を published/ に取得し（コミット対象外）、SHA-256 を検証します。uv run pytest --live は、それらの文書を必要とするテストを実行します。scripts/build.py は derived/ と、QSO Graph の参照データを PostgreSQL に読み込むための load.sql を再生成します（先に QG ADIF の adif スキーマを読み込んでください）。

ライセンス

itu-zones-mcp 自身のコードは GPL-3.0-or-later です。LICENSE を参照してください。このツールが提供するデータは、このページの冒頭にクレジットを記載している所有者のものです。当方のライセンスはこのデータを対象としておらず、当方はデータに対する権利を主張しません。所有者の文書そのものは含まれていません。data/SOURCE.json にその URL と SHA-256 を記録しているため、誰でも事実を照合できます。事実に基づいて当方が作成したファイル（data/derived/）は当方のものであり、その旨を明記しています。所有者の文章をどのように読み取ったかは、docs/TRANSCRIPTION.md に記録しています。NOTICE も参照してください。