cq-zones-mcp

cq-zones-mcp

出典：CQ の WAZ ゾーン定義（「2018 年 4 月 1 日時点で更新・確認済み」）、© CQ Communications, Inc. および World Wide Radio Operators Foundation（WWROF）。40 の CQ ゾーンは CQ によるものです。このパッケージは CQ のリストに基づく情報を提供し、それぞれの情報に出典となるゾーンを明記して、複製するのではなく CQ のページへリンクしています。GPL-3.0 ライセンスが適用されるのは本パッケージのコードであり、CQ のデータではありません。

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

CQ が公開している CQ ゾーン の MCP サーバーです。CQ の WAZ ゾーン定義（2018-04-01）にある 40 のゾーン、すなわち CQ の Worked All Zones アワードおよび CQ World Wide DX Contest で使用されるゾーンを扱います。各ゾーンのエンティティと行政区画は、ADIF 独自の DXCC コードと行政区画コードで記載し、地域を分割している場合は CQ 独自の表現を使用します。

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

インストール

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

ツール

ツール	説明	主なパラメーター
cq_zones_lookup	1 つのゾーンについて、名前、CQ が記載するすべてのエンティティ、行政区画、境界、および出典を確認します	code
cq_zones_codes_for	ADIF DXCC エンティティ、またはその行政区画が対象となるゾーンを確認します	dxcc, subdivision
cq_zones_search	名前、プレフィックス、表現からゾーンを検索します	text, limit
cq_zones_valid_on	指定した日付にゾーンが有効だったかを確認します（CQ ゾーンに有効期間はありません）	code, on_date
cq_zones_source_info	所有者、版、利用条件、所有者のファイルの URL と SHA-256 を確認します	—
get_version_info	サービスのバージョンと、提供する所有者の版を確認します（フリート識別の証明）	—

クイックスタート

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

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

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

Claude Desktop

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

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

Claude Code

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

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

ChatGPT Desktop

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

Cursor

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

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

VS Code / GitHub Copilot

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

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

Gemini CLI

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

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

質問する

「ケベックはどの CQ ゾーンにありますか？」

「CQ ゾーン 23 の対象地域はどこですか？」

「カナダはいくつの CQ ゾーンにまたがっていますか？」

MCP Inspector

cq-zones-mcp --transport streamable-http --port 8016

続いて、http://localhost:8016 で MCP Inspector を開きます。

開発

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

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

ライセンス

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