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.
面向 ARRL Logbook of The World 的只读 MCP 服务器，让助手查询 QSO、QSL 确认、DXCC 积分和呼号活跃情况。
Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。
参照 仓库 中的启动说明。
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.
lotw-mcp uses qso-graph-auth personas for credential management:
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.
Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):
Add to .claude/settings.json:
Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
Add to .vscode/mcp.json in your workspace:
Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):
"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?"
lotw_user_activity works without any credentials. It uses the public LoTW user activity CSV, cached locally for 7 days.
Set the mock environment variable:
LoTW can be slow (30-60s for large queries). lotw-mcp uses 120s timeouts. Use date filters (since, start_date) to limit result sets.
GPL-3.0-or-later
来源：README.md，提交 c22d459
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
Query confirmed QSL records from LoTW.
banddxccmodesincedetailpersona必填callsignLotw Qsos
Query all uploaded QSOs from LoTW (confirmed and unconfirmed).
bandmodesincepersona必填end_datestart_dateLotw Dxcc Credits
Query DXCC award credits from LoTW confirmations.
entitypersona必填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_onlyLotw 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必填已满足适用检查项的 90%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。
uvx lotw-mcp # run it; nothing to install# 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){ "mcpServers": { "lotw": { "command": "uvx", "args": ["lotw-mcp"] } }}{ "mcpServers": { "lotw": { "command": "uvx", "args": ["lotw-mcp"] } }}{ "mcpServers": { "lotw": { "command": "uvx", "args": ["lotw-mcp"] } }}{ "mcpServers": { "lotw": { "command": "uvx", "args": ["lotw-mcp"] } }}{ "servers": { "lotw": { "command": "uvx", "args": ["lotw-mcp"] } }}{ "mcpServers": { "lotw": { "command": "uvx", "args": ["lotw-mcp"] } }}LOTW_MCP_MOCK=1 lotw-mcplotw-mcp --transport streamable-http --port 8004git clone https://github.com/qso-graph/lotw-mcp.gitcd lotw-mcpuv sync --group devuv run pytest