Lotw Mcp

io.github.qso-graph由 GitHub 帳號 qso-graph 發布v0.6.2更新於 Nov 3, 2026

ARRL Logbook of The World MCP server. QSO query, QSL status, DXCC credit tracking.

已驗證STDIO僅桌面位置與生活資料與分析

概覽

AI 產生的概覽

針對 ARRL Logbook of The World 的唯讀 MCP 伺服器,讓助理查詢 QSO、QSL 確認、DXCC 積分與呼號活躍情形。

可以做什麼
  • 依波段、模式、呼號與日期篩選查詢已確認的 QSL 紀錄
  • 查詢所有已上傳的 QSO,包含已確認與未確認
  • 查詢 LoTW 確認紀錄中的 DXCC 獎項積分
  • 以原始 ADIF 文字下載完整日誌,可只取已確認的 QSL
  • 查詢某呼號是否使用 LoTW 以及最近上傳時間
  • 回報服務版本與上游 LoTW 結構版本
適用情境
適合在 LoTW 上記錄通聯的業餘無線電玩家,讓助理回答關於確認數量、未確認 QSO、DXCC 積分進度,或某電台是否活躍於 LoTW 的問題。
執行需求
透過 uvx 在本機執行 Python 套件(需要 uv)。需要憑證的工具須先安裝 qso-graph-auth,建立含呼號與日期範圍的 persona,啟用 lotw 提供者,並在其中儲存 LoTW 使用者名稱與密碼。呼號活躍查詢不需憑證。需要連線至 LoTW 的網路。
安裝前請注意
透過 qso-graph-auth 儲存 LoTW 使用者名稱與密碼,應將該儲存位置視為敏感資料。設計上為唯讀,不支援上傳。大型查詢可能耗時 30 至 60 秒。呼號活躍查詢使用本機快取的公開 CSV,每週更新,結果可能落後。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Lotw Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

lotw-mcp

[PyPI] [MCP Registry]

MCP server for ARRL Logbook of The World (LoTW) — query confirmations, uploaded QSOs, DXCC credits, and user activity through any MCP-compatible AI assistant.

Part of the qso-graph project. Read-only — uploads require TQSL digital signatures and are out of scope.

Install

bash
uvx lotw-mcp            # run it; nothing to install

Tools

ToolAuthDescription
lotw_confirmationsYesQuery confirmed QSLs with band/mode/call/date filters
lotw_qsosYesQuery all uploaded QSOs (confirmed and unconfirmed)
lotw_dxcc_creditsYesDXCC award credits from LoTW confirmations
lotw_downloadYesDownload QSOs as ADIF file
lotw_user_activityNoCheck if a callsign uses LoTW and when they last uploaded
get_version_infoNoService version + upstream LoTW schema version (fleet identity attestation)

Quick Start

1. Set up credentials

lotw-mcp uses qso-graph-auth personas for credential management:

bash
# Install qso-graph-auth if you haven'tuv tool install qso-graph-auth
# A persona (your callsign and the dates it covers), then LoTW for itqso-graph-auth persona add --name ki7mt --callsign KI7MT --start 2020-01-01qso-graph-auth provider enable ki7mt lotwqso-graph-auth creds set ki7mt lotw      # asks for your username, then your password (hidden)

All three steps are needed: without provider enable, the server reports that the persona has no lotw ref.

Note: The LoTW login is usually your callsign but not always. Pre-Sept 2019 accounts may require lowercase passwords. Avoid special characters in passwords.

2. Configure your MCP client

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

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

Add to .claude/settings.json:

json
{  "mcpServers": {    "lotw": {      "command": "uvx",      "args": ["lotw-mcp"]    }  }}
ChatGPT Desktop
json
{  "mcpServers": {    "lotw": {      "command": "uvx",      "args": ["lotw-mcp"]    }  }}
Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

json
{  "mcpServers": {    "lotw": {      "command": "uvx",      "args": ["lotw-mcp"]    }  }}
VS Code / GitHub Copilot

Add to .vscode/mcp.json in your workspace:

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

Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):

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

3. Ask questions

"How many LoTW confirmations did I get this month?"

"Show me all unconfirmed 20m FT8 QSOs uploaded to LoTW in the last 90 days"

"What DXCC credits do I have on 40m CW?"

"Does JA1ABC use LoTW? When did they last upload?"

Public Tool

lotw_user_activity works without any credentials. It uses the public LoTW user activity CSV, cached locally for 7 days.

Testing Without Credentials

Set the mock environment variable:

bash
LOTW_MCP_MOCK=1 lotw-mcp

Performance Notes

LoTW can be slow (30-60s for large queries). lotw-mcp uses 120s timeouts. Use date filters (since, start_date) to limit result sets.

MCP Inspector

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

Development

bash
git clone https://github.com/qso-graph/lotw-mcp.gitcd lotw-mcpuv sync --group devuv run pytest

License

GPL-3.0-or-later

來源:README.md,提交 c22d459

工具

6

get_version_info

Get Version Info

Get lotw-mcp service version and upstream LoTW schema version. Returns the running PyPI version of lotw-mcp and the ARRL LoTW ADIF/CSV export schema in use. Use this to confirm fleet alignment across MCP deployments — agents can compare service_version and spec_version across servers to detect drift without going outside the MCP protocol.

無需輸入參數。

lotw_confirmations

Lotw Confirmations

Query confirmed QSL records from LoTW.

輸入參數banddxccmodesincedetailpersona必填callsign

lotw_qsos

Lotw Qsos

Query all uploaded QSOs from LoTW (confirmed and unconfirmed).

輸入參數bandmodesincepersona必填end_datestart_date

lotw_dxcc_credits

Lotw Dxcc Credits

Query DXCC award credits from LoTW confirmations.

輸入參數entitypersona必填

lotw_download

Lotw Download

Download your complete LoTW log as raw ADIF text. Returns the .adi file content — save to disk for import into your logger. Set qsl_only=True for confirmed QSLs only. Omit 'since' for full history. Warning: large logs may take 30-60 seconds (LoTW is slow).

輸入參數bandmodesincepersona必填qsl_only

lotw_user_activity

Lotw User Activity

Check if a callsign uses LoTW and when they last uploaded. Public endpoint — no authentication required. Uses a locally cached copy of the LoTW user activity CSV (refreshed weekly).

輸入參數callsign必填

版本歷史

11
  1. v0.6.2最新Oct 29, 2026
  2. v0.5.0Oct 26, 2026
  3. v0.4.3Oct 26, 2026
  4. v0.4.1Oct 26, 2026
  5. v0.4.0Oct 12, 2026
  6. v0.3.8Oct 11, 2026
  7. v0.3.7Oct 7, 2026
  8. v0.3.6Oct 6, 2026
  9. v0.3.5Oct 4, 2026
  10. v0.3.4Sep 29, 2026
  11. v0.2.0Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分