itu-zones-mcp

itu-zones-mcp

来源：IARU 的 HF Managers Handbook 第 9.8 章“业余无线电爱好者使用的 ITU 区域定义”（IARU Region 1，v8.2；该章节页面标注的日期为 2000 年 11 月）。业余用途的区域边界线根据 IARU Region 1 建议 REC/99/LH/C4.2 收录于此；这份列表由 G3HTA 根据 ITU 的 CIRAF 区域起草，并经 IARU 的三个区域批准。90 个 ITU 区域属于 IARU：本软件包提供该章节中的信息，每条均注明页码和区域，并链接到手册，而非复制手册内容。我们的 GPL-3.0 许可涵盖我们的代码，不涵盖 IARU 的数据。

核对依据：AD1C 的国家文件（Jim Reisert，AD1C）、ADIF 3.1.7 的行政区区域，以及 ARRL 的 DXCC 列表。测试会从 AD1C 和 ARRL 的网站获取文件，以验证这些信息；此处不包含这两份文件。若内容有差异，以列表所有者的列表为准（参见 docs/TRANSCRIPTION.md）。

适用于 ITU 区域 的 MCP 服务，区域定义依据 IARU 为业余用途发布的内容：即 IARU Region 1 HF Managers Handbook（v8.2）第 9.8 章“业余无线电爱好者使用的 ITU 区域定义”中的 90 个区域，该定义用于 IARU HF Championship 和 ITU 区域奖项。每个区域的前缀均采用 ADIF 自有的 DXCC 和行政区代码；若 IARU 按边界线划分区域，则沿用其原文表述。

本项目属于 qso-graph 项目。无需联网，无需身份验证：列表所有者提供的信息随软件包一同发布，每条回答都会注明来源。

安装

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

工具

工具	描述	关键参数
itu_zones_lookup	查询一个区域：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

然后打开 MCP Inspector：http://localhost:8017。

开发

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/ 和 load.sql，后者是用于加载 QSO Graph 参考数据的 PostgreSQL 文件（请先加载 QG ADIF 的 adif 架构）。

许可证

itu-zones-mcp 自身的代码采用 GPL-3.0-or-later 许可。请参阅 LICENSE。它提供的数据归所有者所有，所有者已在本页顶部注明：我们的许可证不涵盖这些数据，我们也不主张对其拥有任何权利。所有者的文档本身未包含在内；data/SOURCE.json 记录了其 URL 和 SHA-256，供任何人据此核对事实。我们根据这些事实制作的文件（data/derived/）归我们所有，并已标明归属。关于如何读取所有者文本的记录，请参阅 docs/TRANSCRIPTION.md。请参阅 NOTICE。