Adif Mcp

adif-mcp

ADIF 3.1.7仕様に対応したMCP サーバーです。ADIFレコードの検証と解析、仕様のフィールド、列挙型、データ型の検索、Maidenheadロケーター間の距離と方位の計算を、MCP互換のAI アシスタントで行えます。

qso-graphプロジェクトの一部です。認証は不要です — ADIF仕様が同梱されているため、オフラインでも動作します。

インストール

uvx adif-mcp            # run it; nothing to install

ツール

ツール	説明	主なパラメーター
validate_adif_record	ADIFレコードを3.1.7仕様に照らして検証します	adif_string
parse_adif	ページネーションに対応した、大きなADIFファイル向けのストリーミングパーサーです	file_path, start_at, limit
read_specification_resource	任意の仕様モジュール（band、mode、fieldsなど）の生JSONを取得します	resource_name
list_enumerations	ADIFのすべての列挙型とエントリー数を一覧表示します	—
search_enumerations	キーワードで列挙型のレコードを検索します	search_term, enumeration
calculate_distance	2つのMaidenheadロケーター間の大圏距離（km）を計算します	start, end
calculate_heading	2つのロケーター間の初期ビーム方位（方位角）を計算します	start, end
get_version_info	サービスのバージョンと上流仕様のバージョン（フリートの識別情報の証明）を取得します	—

ADIFとは？

ADIF（Amateur Data Interchange Format）は、アマチュア無線のログ記録プログラムがQSOレコードを交換するために使用する標準ファイル形式です。adif-mcpはqso-graphの仕様パッケージです。ADIFの検証、解析、検索を行い、アシスタントがログを安全かつ正確に扱えるようにします。認証情報はqso-graph-authで別途管理され、各ログ記録サービスには専用のMCP サーバーがあります（qso-graph.ioを参照）。

クイックスタート

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

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

adif-mcpは、MCP互換クライアントであればどれでも動作します。サーバー設定を追加して再起動してください。ツールが自動的に表示されます。

Claude Desktop

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

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

Claude Code

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

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

ChatGPT Desktop

Settings > Apps & Connectorsから設定するか、エージェント定義に追加します。

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

Cursor

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

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

VS Code / GitHub Copilot

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

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

Gemini CLI

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

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

質問する

「このADIFレコードは有効ですか？ CALL:5KI7MT<QSO_DATE:8>20260928BAND:320mMODE:3SSB」

「ADIF MODE列挙型で、デジタルモードに使用できる値は何ですか？」

「ログファイルを解析して、最初の50件のQSOを表示してください。」

「DN13からJN48までの距離はどのくらいで、ビームを向ける方位はどちらですか？」

バリデーターによるチェック内容

adif-mcp は、ADIF が公開している内容そのままに、ADIF 3.1.7 の 186 個のフィールド、25 個の列挙型、28 個のデータ型を提供します。 validate_adif_record は、各フィールドを ADIF のデータ型に照らして検証し、列挙型フィールドについては列挙値も検証します。

• 列挙値は大文字と小文字を区別せずに照合されるため、LoTW の BAND=15M は 15m として受け入れられます。
• インポート専用の値（たとえば、Mode 列挙型の 91 個の値のうち 42 個）はエラーではなく警告になります。ADIF ではインポート時に使用できますが、新しいレコードには使用できません。
• CREDIT_SUBMITTED（Credit または Credit:Medium の項目のリスト）などの複合値は、項目ごとに検証されます。
• SUBMODE は有効な Submode である必要があります。異なる MODE に属する場合は警告になります。たとえば、FT4 は MODE=MFSK、SUBMODE=FT4 です。
• 構造化型は、ADIF が定める文法に照らして検証されます。グリッドロケーター（大文字小文字を問わず 2、4、6、または 8 文字）とその拡張およびリスト（VUCC では 4 文字または 6 文字の項目が 2 つまたは 4 つ必要です）、Location（XDDD MM.MMM）、Boolean（Y または N）、IOTA、WWFF、POTA、SOTA の参照が対象です。文法上は許可されても正しくない値、たとえば緯度が 90 度を超える値や、経度に N/S を指定した値は、エラーではなく常に警告になります。

また、サーバーは MCP リソース adif://system/version を公開しています。このリソースでは、サービスのバージョンと、提供する ADIF 仕様のバージョンを確認できます。

MCP Inspector

adif-mcp --transport streamable-http --port 8003

次に、http://localhost:8003 で MCP Inspector を開きます。

開発

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

ライセンス

adif-mcp 独自のコードは GPL-3.0-or-later です。詳細は LICENSE を参照してください。

ADIF 仕様ファイルは当プロジェクトのものではありません。 パッケージには、ADIF が公開している 2 つのバージョン（現在は前バージョンの 3.1.6 と現行バージョンの 3.1.7）のファイルが、変更されていない状態で含まれています。ADIF のリソース ZIP に含まれるテスト用資料を除いたすべてのファイルを、ADIF が公開しているすべての形式（JSON、all.xml と XSD を含む XML、CSV、TSV、XLSX、ODS）で収録し、バージョンごとの SHA-256 を記載した MANIFEST.json も含めています。これらは ADIF Developers Group が公開したものです。ADIF の著作物であり、当プロジェクトのライセンスの対象外です。このフォルダー内で当プロジェクトが作成したファイルは、派生した Country 列挙型と各バージョンの MANIFEST.json のみです。NOTICE を参照してください。