Netlogger Mcp

io.github.qso-graphv0.1.3更新於 Sep 29, 2026

NetLogger MCP server. Nets on the air, live check-ins and who's up, past nets.

已驗證STDIO僅桌面Cloud & Infrastructure

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

netlogger-mcp

[PyPI] [MCP Registry]

MCP server for NetLogger: nets on the air now, live check-in lists and who's up, and past nets and their check-ins, through any MCP-compatible AI assistant.

Data from NetLogger's public XML Data Service (API 1.3). Part of the qso-graph project. No API key needed. Your callsign is asked for once (see below).

Install

bash
uvx netlogger-mcp            # run it; nothing to installpip install netlogger-mcp    # or install it into your own environment

Tools

ToolDescriptionKey Parameters
netlogger_active_netsNets on the air now: frequency, band, mode, net control, logger, monitoring countname_like
netlogger_checkinsA live net's check-in list, plus the pointer (the station being worked now)server_name, net_name
netlogger_past_netsClosed nets over the last N days, with the net IDs past check-ins needinterval_days, name_like
netlogger_past_checkinsA closed net's check-in listserver_name, net_name, net_id
netlogger_set_callsignSave your callsign (asked once, on first use)callsign
get_version_infoService version + upstream spec version (fleet identity attestation)—

What is NetLogger?

NetLogger is the logging program many amateur-radio nets use: net control or a logger keeps the check-in list, and anyone can follow the net live. Its server publishes active nets, check-in lists and past nets through a public API.

Your Callsign

Every request tells NetLogger which station is asking, so it can tell one user from another:

netlogger-mcp/0.1.0 (KI7MT; +https://github.com/qso-graph/netlogger-mcp)

On first use the assistant asks for your callsign and saves it. You're asked once. To set it yourself, use NETLOGGER_MCP_CALLSIGN=KI7MT.

It's saved in settings.json, in ~/.config/netlogger-mcp/ (Linux), ~/Library/Application Support/netlogger-mcp/ (macOS) or %APPDATA%\netlogger-mcp\ (Windows).

Good Neighbour Policy

NetLogger is a donation-funded service on one server, and it limits how often each call may be made. We keep to those limits:

MeasureDetail
NetLogger's call limitsGetActiveNets 1/min, GetCheckins 3/min, GetPastNets 1/min, GetPastNetCheckins 10/min. Checked before a request is sent, never after.
One budget per userEvery copy you run (Claude Desktop, Claude Code, a script) shares one budget, through a locked file beside settings.json.
Shared answersEvery copy also shares the answers it fetched, so a copy that has hit the limit gets another copy's recent answer, with its age, instead of an error.
Response cachingActive nets 60 s, check-ins 20 s, past nets 60 s, past check-ins 1 hour. Filtering by name costs no extra calls.
Stale answers over errorsWhen a limit is reached, the last answer comes back with its age rather than a new request.
429 back-offA "too many requests" on any call stops all calls for at least a minute, longer if NetLogger asks.
Past-net windowsMore than 7 days of past nets needs a name filter, NetLogger's rule to protect its server.
Request timeout15-second timeout.
User-Agent headerEvery request names this project and your callsign, so NetLogger's operators can see who is asking.

Privacy

NetLogger's check-in data includes street addresses and ZIP codes, and past nets include the IP address of whoever opened them. None of these are ever returned.

Quick Start

Configure your MCP client

netlogger-mcp works with any MCP-compatible client. Add the server config and restart. The tools appear automatically.

Claude Desktop

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

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

Add to .claude/settings.json:

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

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

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

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

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

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

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

Installed with pip instead? Use "command": "netlogger-mcp" in any config above.

Ask questions

"What nets are on the air right now?"

"Are any 80m nets running?"

"Who's checked into the county ARES net, and who's up now?"

"Which nets ran in the last three days?"

"Show me the check-ins from last night's net."

As a Python Library

The same code works without an AI, with the same limits and cache. A library can't ask for your callsign, so you pass it in:

python
from netlogger_mcp.netlogger import NetLoggerSource
nl = NetLoggerSource(callsign="KI7MT")for net in nl.active_nets()["nets"]:    live = nl.checkins(net["server"], net["name"])    print(net["name"], "up now:", live["pointer_callsign"])

Apps can also name themselves, using ADIF's PROGRAMID and PROGRAMVERSION: NetLoggerSource(callsign="KI7MT", program_id="MyLogger", program_version="1.0").

Testing Without Network

bash
NETLOGGER_MCP_MOCK=1 netlogger-mcp

MCP Inspector

bash
netlogger-mcp --transport streamable-http --port 8014

Development

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

License

GPL-3.0-or-later

來源：README.md，提交 7f4c502

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.3最新Sep 29, 2026