Lotw Mcp

lotw-mcp

ARRL Logbook of The World（LoTW）用のMCP サーバーです。MCP 対応のあらゆるAI アシスタントから、交信確認、アップロード済みQSO、DXCC クレジット、ユーザーのアクティビティを照会できます。

qso-graphプロジェクトの一部です。読み取り専用です。アップロードにはTQSLデジタル署名が必要なため、対象外です。

インストール

uvx lotw-mcp            # run it; nothing to install

ツール

ツール	認証	説明
lotw_confirmations	はい	バンド／モード／コール／日付で絞り込み、確認済みQSLを照会します
lotw_qsos	はい	アップロード済みのすべてのQSO（確認済みと未確認）を照会します
lotw_dxcc_credits	はい	LoTWの交信確認によるDXCCアワードのクレジットを照会します
lotw_download	はい	QSOをADIFファイルとしてダウンロードします
lotw_user_activity	いいえ	コールサインがLoTWを利用しているか、最後にアップロードした日時を確認します
get_version_info	いいえ	サービスのバージョンと上流LoTWスキーマのバージョン（フリートの識別情報の証明）

クイックスタート

1. 認証情報を設定する

lotw-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 LoTW for it
qso-auth persona add --name ki7mt --callsign KI7MT --start 2020-01-01
qso-auth provider enable ki7mt lotw
qso-auth creds set ki7mt lotw      # asks for your username, then your password (hidden)

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

注：LoTWのloginは通常コールサインですが、常にそうとは限りません。2019年9月より前に作成されたアカウントでは、パスワードを小文字にする必要がある場合があります。パスワードには特殊文字を使わないでください。

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

Claude Desktop

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

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

Claude Code

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

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

ChatGPT Desktop

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

Cursor

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

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

VS Code / GitHub Copilot

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

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

Gemini CLI

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

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

3. 質問する

「今月、LoTWで何件の交信確認を受けましたか？」

「過去90日間にLoTWへアップロードした、未確認の20m FT8 QSOをすべて表示して」

「40m CWで獲得しているDXCCクレジットは何ですか？」

「JA1ABCはLoTWを使っていますか？最後にアップロードしたのはいつですか？」

公開ツール

lotw_user_activityは認証情報なしで動作します。公開LoTWユーザーアクティビティCSVを使用し、ローカルに7日間キャッシュします。

認証情報なしでのテスト

モック環境変数を設定します。

LOTW_MCP_MOCK=1 lotw-mcp

パフォーマンスに関する注意

LoTWの処理には時間がかかることがあります（大量のクエリでは30～60秒）。lotw-mcpではタイムアウトを120秒に設定しています。結果を絞り込むには、日付フィルター（since、start_date）を使用してください。

MCP Inspector

lotw-mcp --transport streamable-http --port 8004

開発

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

ライセンス

GPL-3.0-or-later