darc-dok-mcp

darc-dok-mcp

出典：Deutscher Amateur-Radio-Club e.V.（DARC）： DOK-Liste（DARC DX-Referat、Karsten Radwan、DL2ABM、2016年12月26日）および特別 DOK リスト（DARC SDOK-Referat）。DOK は DARC のものです。このパッケージは、各行を出典のページまたは行番号とともに事実として提供し、DARC のファイルを複製せずにリンクします。GPL-3.0 ライセンスの対象はコードであり、DARC のデータではありません。

DARC が公開しているDARC DOK と特別 DOKの MCP サーバーです。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	1 つの 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 を再生成します。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 もご覧ください。