omiss-mcp

omiss-mcp

OMISS、Old Man International Sideband Society の MCP サーバーです。ネットのスケジュール、現在オンエア中の OMISS ネット、会員検索、過去のネットとチェックインした人、州制定記念スケジュール、役員、賞、ネット統計を、MCP 対応の AI アシスタントから利用できます。

データは omiss.net の公開ページから取得し、オンエア中のネット情報は NetLogger から取得します。qso-graph プロジェクトの一部です。ログインも API キーも不要です。

インストール

uvx omiss-mcp            # run it; nothing to install

ツール

ツール	説明	主なパラメーター
omiss_net_schedule	すべてのネットのバンド、UTC 時刻、周波数、開催曜日、バンドコーディネーター、次回開催日。祝日の日付も含みます	—
omiss_nets_on_air	NetLogger から取得した現在オンエア中の OMISS ネット。それぞれをネットスケジュールと照合します	—
omiss_member_lookup	1 人の会員：OM 番号、コールサイン、氏名、ステータス、グリッド、州、郡、最終チェックイン	callsign または om_number
omiss_checkin_history	過去のネットを新しい順に表示します。必要に応じて、会員、バンド、日付で絞り込めます	callsign、om_number、band、date、net_control
omiss_net_checkins	1 件の過去のネット：ネットコントロール、リレー、メモ、チェックイン一覧	net_id
omiss_statehood_schedule	40m ネットの日程と、各回で自由にコールできる州、および次回開催日	—
omiss_officers	役員、バンドコーディネーター、委員会、任命者、歴代会長	—
omiss_awards	賞の一覧と、ほかの賞関連ツールで使用する ID	—
omiss_award_rules	1 つの賞の規則、またはすべての賞の概要	award_id
omiss_award_recipients	賞の受賞者を新しい順に表示するか、特定の会員を確認します	award_id、callsign、om_number
omiss_net_statistics	バンド別のネット数、バンドごとの最終ネット、チェックイン数とネットコントロールの上位者、州別の最終チェックイン	state、top
omiss_eligibility	コールサインのリスト（あるネットのチェックイン）について、会員かどうか、OM 番号、サイレントキー、軍関係者、ファーストレスポンダー、州都の名簿を確認します	callsigns
omiss_set_callsign	omiss_nets_on_air 用にコールサインを保存します（初回のみ確認）	callsign
get_version_info	サービスのバージョンと上流仕様のバージョン（フリート識別の証明）	—

OMISS とは？

OMISS はアマチュア無線の協会で、毎日、10 メートルから 160 メートルの HF 帯で SSB ネットを運営しています。会員はネット上で OM 番号を交換し、協会の賞の獲得を目指します。ウェブサイトでは、ネットのスケジュール、会員名簿、すべてのネットのチェックイン履歴、賞の規則と受賞者を公開しています。

ネットは予定より早く開始することがあります

ネットコントロールは、予定時刻よりかなり前に NetLogger でネットを開き、チェックインを受け付けることがよくあります（40m ネットは 35 分早く開始したことがあります）。omiss_net_schedule では予定時刻を確認でき、omiss_nets_on_air ではネットが現在開いているかどうかを確認できます。

コールサイン

コールサインが必要なのは omiss_nets_on_air だけです。NetLogger に問い合わせる際、どの局からの問い合わせかを伝える必要があります。初回の利用時にアシスタントがコールサインを尋ね、保存します。確認は一度だけです。ほかのツールでは不要です。

良き隣人ポリシー

omiss.net はボランティアが運営するクラブのウェブサイトであり、API ではありません。節度をもって利用します。

項目	詳細
一度に 1 件のリクエスト	2 秒ごとに最大 1 件のリクエストを送信します。設定フォルダー内のロックファイルを通じて、実行中のすべてのコピー（Claude Desktop、Claude Code、スクリプト）で共有されます。
レスポンスのキャッシュ	スケジュール、役員、Statehood、メンバー、受賞者は 24 時間、賞とルールは 7 日間、履歴と統計は 1 時間キャッシュされます。
エラーより古い回答を優先	サイトがダウンまたは混雑している場合、エラーではなく、最終回答とその経過時間を返します。
バックオフ	「リクエストが多すぎる」または「利用不可」という回答が返された場合、少なくとも 1 分間、すべてのリクエストを停止します。サイトからさらに長い時間を求められた場合は、それに従います。
リクエストのタイムアウト	タイムアウトは 20 秒です。
User-Agent ヘッダー	サイトの運営者がリクエスト元を確認できるよう、すべてのリクエストにこのプロジェクト名を指定します。
NetLogger	omiss_nets_on_air は NetLogger の呼び出し制限を守ります。netlogger-mcp（netlogger-mcp）も実行している場合は、制限を共有します。

セキュリティとプライバシー

• すべての値は送信前に検証されます：コールサイン、OM 番号、固定リストから選ぶバンド、YYYY、YYYY-MM または YYYY-MM-DD 形式の日付、数値のネット ID、サイト独自のリストにある賞の ID を検証します。自由記述テキストが omiss.net に送信されることはありません。
• ページに表示されている場合も、郵便住所やメールアドレスが返されることはありません。
• メンバーはコールサインまたは OM 番号で、一度に 1 人ずつ検索します。州、郡、グリッドでの検索や、名簿のダウンロードには対応していません。

クイックスタート

MCP クライアントの設定

omiss-mcp は MCP 対応クライアントであればどれでも動作します。サーバー設定を追加して再起動すると、ツールが自動的に表示されます。

Claude Desktop

claude_desktop_config.json（macOS では ~/Library/Application Support/Claude/、Windows では %APPDATA%\Claude\）に追加します。

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

Claude Code

.claude/settings.json に追加します。

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

ChatGPT Desktop

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

Cursor

.cursor/mcp.json（プロジェクトレベル）または ~/.cursor/mcp.json（グローバル）に追加します。

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

VS Code / GitHub Copilot

ワークスペースの .vscode/mcp.json に追加します。

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

Gemini CLI

~/.gemini/settings.json（グローバル）または .gemini/settings.json（プロジェクト）に追加します。

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

質問する

「OMISS の 40m ネットはいつで、周波数はいくつですか？」

「KI7MT は OMISS のメンバーですか？ OM 番号はいくつですか？」

「現在運用中の OMISS ネットはどれですか？」

「OM 7212 は今年、どのネットにチェックインしましたか？」

「昨夜の 80m ネットにチェックインしたのは誰ですか？」

「次の 40m Statehood ネットでフリーコールの対象となる州はどこですか？」

「Alphabet Soup 賞の要件は何ですか？ 私は獲得していますか？」

「過去 90 日間に、ネットコントロールとして最も多くの OMISS ネットを運営したのは誰ですか？」

Python ライブラリとして使用

AI を使わない場合も、同じ間隔制御とキャッシュを備えた同じコードを利用できます。

from omiss_mcp.omiss import OmissSource

om = OmissSource()
me = om.member_lookup(callsign="KI7MT")["members"][0]
for net in om.checkin_history(om_number_=me["om_number"], date_="2026")["nets"]:
    print(net["time"], net["name"], net["checkin_count"])

アプリでは、ADIF の PROGRAMID と PROGRAMVERSION を使ってアプリ名を指定できます：OmissSource(program_id="MyLogger", program_version="1.0")。

ネットワーク接続なしでテスト

OMISS_MCP_MOCK=1 omiss-mcp

MCP Inspector

omiss-mcp --transport streamable-http --port 8015

開発

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

ライセンス

GPL-3.0-or-later