Hamqth Mcp

hamqth-mcp

HamQTH.com 用の MCP サーバーです。あらゆる MCP 対応 AI アシスタントから、コールサイン検索、DX クラスタースポット、Reverse Beacon Network、DXCC の解決などを利用できます。

qso-graph プロジェクトの一部です。認証が必要なツールは、ペルソナと認証情報の管理に qso-graph-auth を使用します。

インストール

uvx hamqth-mcp            # run it; nothing to install

ツール

ツール	認証	説明
hamqth_lookup	はい	コールサイン検索（名前、グリッド、DXCC、座標、QSL の設定）
hamqth_dxcc	いいえ	コールサインまたは ADIF コードから DXCC エンティティを解決
hamqth_bio	はい	オペレーターの経歴を取得
hamqth_activity	はい	最近の DX クラスター、RBN、ログブックのアクティビティ
hamqth_dx_spots	いいえ	ライブ DX クラスタースポット — バンドやコールサインで絞り込み
hamqth_rbn	いいえ	Reverse Beacon Network のデコード — バンド、モード、大陸、コールサインで絞り込み
hamqth_verify_qso	いいえ	HamQTH SAVP プロトコルで QSO を検証
get_version_info	いいえ	サービスのバージョンと上流 HamQTH API のバージョン（フリート ID の証明）

クイックスタート

1. HamQTH の無料アカウントを作成する

hamqth.com で登録してください。無料で、サブスクリプションは不要です。

2. 認証情報を設定する

hamqth-mcp は、認証情報の管理に qso-graph-auth のペルソナを使用します。

# Install qso-graph-auth if you haven't
uv tool install qso-graph-auth

# A persona (your callsign and the dates it covers), then HamQTH for it
qso-auth persona add --name ki7mt --callsign KI7MT --start 2020-01-01
qso-auth provider enable ki7mt hamqth
qso-auth creds set ki7mt hamqth      # asks for your username, then your password (hidden)

3 つの手順すべてが必要です。provider enable を実行しないと、サーバーはペルソナに hamqth の参照がないと報告します。

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

hamqth-mcp はあらゆる MCP 対応クライアントで動作します。サーバー設定を追加して再起動すると、ツールが自動的に表示されます。

Claude Desktop

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

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

Claude Code

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

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

ChatGPT Desktop

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

Cursor

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

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

VS Code / GitHub Copilot

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

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

Gemini CLI

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

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

4. 質問する

「コールサイン OK2CQR を検索して」

「VP8PJ の DXCC エンティティは何？」

「OK2CQR の経歴を表示して」

「KI7MT の最近のアクティビティは？」

「3Y0K の DX スポットを表示して」

「CW での 3Y0K の RBN デコードはある？」

「20m の DX スポットを表示して」

「3 月 5 日の 20m での OK2CQR との QSO を検証して」

認証情報なしでのテスト

DXCC ツール（hamqth_dxcc）は認証情報なしで動作します。公開エンドポイントを使用するためです。

HamQTH アカウントなしですべてのツールをテストするには、次のようにします。

HAMQTH_MCP_MOCK=1 hamqth-mcp

MCP Inspector

hamqth-mcp --transport streamable-http --port 8005

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

開発

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

既知の注意点

• セッション： HamQTH の XML セッションは 1 時間後に期限切れになります。サーバーは 55 分後に再度サインインするため、長時間実行されるセッションでも期限切れのセッションに遭遇することはありません。

ライセンス

GPL-3.0-or-later