n1mm-mcp

n1mm-mcp

N1MM Logger+用のMCP サーバーです。ステーション、QSO、バンドマップ、スコアとレート、マルチプライヤー、コンテスト時計など、コンテストのライブ状態を、あらゆるMCP互換AI アシスタントから利用できます。

データは、ローカルネットワーク上で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	ライブスポット、マルチプライヤーの目標、バンドアクティビティ	band, mode, callsign, mults_only
n1mm_performance	スコア、レート、バンド、ラン／S&P、時間ごとのタイムライン	band, mode
n1mm_multipliers	マルチプライヤーのグリッド、必要なもの、価値分析	band
n1mm_clock	コンテストの時間、休憩時間、ペース配分	duration_hours, target_score, target_qsos, min_gap_minutes
n1mm_diagnostics	サーバーの状態、解析エラー、メモリー	station_name
n1mm_so2r	2台の無線機：各無線機の現在の状態、送受信フォーカス、同一バンドの警告、送信時間とバンドごとの分数、フォーカス切り替え、無線機ごとの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でブロードキャストできます。交信、スポット、無線機情報、スコアなどが含まれます。n1mm-mcpはそのブロードキャストを受信してコンテストの状態をメモリーに保持するため、アシスタントが質問に答えられます。N1MMは、n1mm-mcpの存在を認識しません。

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が「このPC」を示すアドレスです。n1mm-mcpはデフォルトでここをリッスンし、PC外からアクセスすることはできません。

別のPCでN1MMを使う場合

n1mm-mcpを--bind 0.0.0.0（すべてのネットワークインターフェース）または--bind <this PC's LAN address>で起動し、N1MMの送信先にこのPCのアドレス（192.168.1.20:12060）か、ネットワーク上のすべてのPCに届くサブネットのブロードキャストアドレス（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"]
    }
  }
}

質問する

「直近 1 時間のレートはどれくらいですか？」

「20m でまだ必要なマルチプライヤーはどれですか？」

「バンドマップに表示されている局は新しいマルチプライヤーですか？」

「休止時間はどれくらい使いましたか？目標達成のペースに乗っていますか？」

「直近 10 件の QSO を表示してください。」

CLI オプション

オプション	デフォルト	説明
--port	12060	UDP リッスンポート
--bind	127.0.0.1	リッスンするアドレス。別の PC 上の 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

次に、MCP Inspector を http://localhost:8008 で開きます。

開発

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