darc-dok-mcp

darc-dok-mcp

来源：德国业余无线电俱乐部协会（DARC）：DOK-Liste（DARC DX 部门，作者 Karsten Radwan、DL2ABM，2016 年 12 月 26 日）和特殊 DOK 列表（DARC SDOK 部门）。DOK 归 DARC 所有：此软件包将列表中的行作为事实提供，每条事实均注明其页码或行号，并链接到 DARC 的文件，而非复制这些文件。我们的 GPL-3.0 许可证仅适用于我们的代码，不适用于 DARC 的数据。

用于查询 DARC DOK 和特殊 DOK 的 MCP 服务，数据遵循 DARC 发布的内容：DARC DOK-Liste（2016-12-26）中的本地俱乐部代码，以及 DARC 特殊 DOK 列表中的活动代码，并包含每个特殊 DOK 的有效期。DOK 用于 DARC 的 DLD 奖项、DOK 排名榜和 WAG 比赛，也用于 ADIF 的 DARC_DOK 字段。

这是 qso-graph 项目的一部分。无需网络连接，无需身份验证：所有者列表中的事实随软件包一同提供，每个回答都会注明来源。

安装

uvx darc-dok-mcp            # run it; nothing to install

工具

工具	描述	关键参数
darc_dok_lookup	查询一个 DOK 或特殊 DOK：地区和俱乐部，或用途、呼号、有效期和赞助俱乐部	code
darc_dok_valid_on	查询某个 DOK 或特殊 DOK 在某个 QSO 日期是否有效	code, on_date
darc_dok_search	按俱乐部、城镇、地区或用途查找 DOK	text, limit
darc_dok_codes_for	为共用工具集保留；DOK 不对应任何 ADIF 行政区划	dxcc, subdivision
darc_dok_source_info	所有者、版本、条款，以及所有者文件的 URL 和 SHA-256 值	—
get_version_info	服务版本 + 所提供的所有者版本（集群身份证明）	—

快速开始

无需凭据——只需安装并配置 MCP 客户端。

配置 MCP 客户端

darc-dok-mcp 兼容所有 MCP 客户端。添加服务配置并重启，工具便会自动显示。

Claude Desktop

添加到 claude_desktop_config.json（macOS 上为 ~/Library/Application Support/Claude/，Windows 上为 %APPDATA%\Claude\）：

{
  "mcpServers": {
    "darc-dok": {
      "command": "uvx",
      "args": ["darc-dok-mcp"]
    }
  }
}

Claude Code

添加到 .claude/settings.json：

{
  "mcpServers": {
    "darc-dok": {
      "command": "uvx",
      "args": ["darc-dok-mcp"]
    }
  }
}

ChatGPT Desktop

{
  "mcpServers": {
    "darc-dok": {
      "command": "uvx",
      "args": ["darc-dok-mcp"]
    }
  }
}

Cursor

添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "darc-dok": {
      "command": "uvx",
      "args": ["darc-dok-mcp"]
    }
  }
}

VS Code / GitHub Copilot

添加到工作区中的 .vscode/mcp.json：

{
  "servers": {
    "darc-dok": {
      "command": "uvx",
      "args": ["darc-dok-mcp"]
    }
  }
}

Gemini CLI

添加到 ~/.gemini/settings.json（全局）或 .gemini/settings.json（项目级）：

{
  "mcpServers": {
    "darc-dok": {
      "command": "uvx",
      "args": ["darc-dok-mcp"]
    }
  }
}

提问

“DOK A01 对应哪个俱乐部？”

“特殊 DOK 01ALT 在 2004-06-01 是否有效？”

“Baden 地区有哪些 DOK？”

MCP Inspector

darc-dok-mcp --transport streamable-http --port 8018

然后在 http://localhost:8018 打开 MCP Inspector。

开发

git clone https://github.com/qso-graph/darc-dok-mcp.git
cd darc-dok-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 架构）。

许可证

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