n1mm-mcp

n1mm-mcp

适用于 N1MM Logger+ 的 MCP 服务：通过任何兼容 MCP 的 AI 助手获取实时比赛状态，包括电台、QSO、波段地图、得分和速率、乘数以及比赛时钟。

数据来自本地网络中 N1MM Logger+ 的 UDP 广播。属于 qso-graph 项目。无需身份验证。

安装

uvx n1mm-mcp            # run it; nothing to install

工具

工具	描述	关键参数
n1mm_current_state	电台快照：连接、比赛、操作员、电台设备	station_name
n1mm_lookup	正在输入的呼号（记录前），以及当前波段和模式	station_name
n1mm_contacts	QSO 日志：近期联络、编辑和删除	count, since, band, mode, call_pattern
n1mm_bandmap	实时 DX 信息、乘数目标、波段活动	band, mode, callsign, mults_only
n1mm_performance	得分、速率、波段、CQ 呼叫/搜索与呼叫、每小时时间线	band, mode
n1mm_multipliers	乘数网格、待获取项、价值分析	band
n1mm_clock	比赛计时、离线时间、进度	duration_hours, target_score, target_qsos, min_gap_minutes
n1mm_diagnostics	服务健康状况、解析错误、内存	station_name
n1mm_so2r	两部电台：各电台当前状态、发射/接收焦点、同波段警告、发射时间和各波段分钟数、焦点切换、每部电台的 QSO 数及另一部电台运行时的 QSO 数	station_name
n1mm_network	每个联网电台：操作员、电台设备、速率、空闲时间、波段、每个比赛呼号的共享得分、共享波段和模式的电台、每位操作员的 QSO 数	—
n1mm_pileup	DX 远征式呼叫堆积：速率、唯一呼号、重复呼号、呼叫的洲和国家、异频工作、静默时间	window_minutes
get_version_info	服务版本 + 上游规范版本（设备集群身份证明）	—

除覆盖所有电台的 n1mm_network 外，每个工具都接受可选的 station_name，以支持多电台配置。

所有数据都来自 N1MM 的 UDP 广播；n1mm-mcp 从不与电台通信。只有 N1MM 自己操作电台发射时（宏、其 CW 电键）才会报告发射，因此通过电键或麦克风 PTT 发射不会计入 n1mm_so2r 的发射时间。

什么是 N1MM Logger+？

N1MM Logger+ 是一款 Windows 比赛日志软件。它可以通过 UDP 广播状态信息：联络、DX 信息、电台信息和得分。n1mm-mcp 会监听这些广播并将比赛状态保存在内存中，因此助手可以回答相关问题。N1MM 不会察觉它的存在。

N1MM Logger+ (Windows)
    │ UDP broadcast (port 12060, XML)
    ▼
n1mm-mcp (Python: the same PC, or any OS on the LAN)
    ├── UDP listener (background)
    ├── State engine (in memory, per StationName)
    │   MCP protocol (stdio)
    ▼
AI assistant

快速开始

启用 N1MM 的广播

1. 在 N1MM 中：Config → Configure Ports → Broadcast Data，然后启用所有消息类型。
2. 将目标地址设为 127.0.0.1:12060，这是 N1MM 用来表示“此电脑”的地址。n1mm-mcp 默认在此监听， 电脑外部无法访问该地址。

N1MM 在另一台电脑上

使用 --bind 0.0.0.0（所有网络接口）或 --bind <this PC's LAN address> 运行 n1mm-mcp， 然后将 N1MM 的目标地址设为此电脑的地址（192.168.1.20:12060），或设为子网的广播地址 （192.168.1.255:12060），以触达该子网中的每台电脑。N1MM 支持用空格分隔多个目标地址。不要使用 255.255.255.255：N1MM 自己的文档警告，这可能会向互联网广播 （N1MM：外部 UDP 广播）。

在网络上监听意味着网络中的任何设备都可以向 n1mm-mcp 发送数据包，因此只应在可信网络上这样做。

配置 MCP 客户端

n1mm-mcp 适用于任何兼容 MCP 的客户端。添加服务配置并重启即可。工具会自动显示。

Claude Desktop

添加到 claude_desktop_config.json（macOS 上为 ~/Library/Application Support/Claude/，Windows 上为 %APPDATA%\Claude\）：

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

Claude Code

添加到 .claude/settings.json：

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

ChatGPT Desktop

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

Cursor

添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

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

VS Code / GitHub Copilot

添加到工作区中的 .vscode/mcp.json：

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

Gemini CLI

添加到 ~/.gemini/settings.json（全局）或 .gemini/settings.json（项目级）：

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

提问

“过去一小时我的速率是多少？”

“我在 20m 频段还缺哪些系数？”

“频段图上的电台是一个新的系数吗？”

“我用了多少休息时间？我的进度符合目标吗？”

“显示最近 10 个 QSO。”

CLI 选项

选项	默认值	说明
--port	12060	UDP 监听端口
--bind	127.0.0.1	监听地址；如果 N1MM 在另一台电脑上，请使用 0.0.0.0
--transport	stdio	MCP 传输方式（stdio 或 streamable-http）
--heartbeat-timeout	60	连接变为过期状态前的秒数
--stale-timeout	900	连接变为断开状态前的秒数
--max-spots	2000	频段图缓冲区中的最大波点数
--spot-ttl	30	波点存活时间，单位为分钟

不使用 N1MM 进行测试

N1MM_MCP_MOCK=1 n1mm-mcp

MCP Inspector

n1mm-mcp --transport streamable-http

然后在 http://localhost:8008 打开 MCP Inspector。

开发

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

许可证

GPL-3.0-or-later