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	查询一个区域：其名称，以及 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，后者是用于 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。