ionis-mcp

ionis-mcp

IONIS-AI のデータセットを使用した HF 無線伝搬解析のための MCP サーバーです。2005～2026 年の WSPR、RBN、コンテスト、DX ペディション、PSK Reporter の観測データ 140 億件から生成された 1 億 7,500 万件以上の集約済みシグネチャを、MCP 対応の AI アシスタントから利用できます。

qso-graph プロジェクトの一部です。認証は不要です。 データセットは一度ダウンロードすれば利用できます（データセットを参照）。

インストール

uv tool install ionis-mcp         # puts ionis-mcp and ionis-download on your PATH
ionis-download --bundle minimal   # 454 MB; see Datasets for the other bundles

または、pip を使用します：pip install ionis-mcp。

ツール

ツール	説明	主なパラメーター
list_datasets	利用可能なデータセットと行数、ファイルサイズ	—
query_signatures	ソース、バンド、グリッド、時刻、月で絞り込んだシグネチャ検索	source, band, tx_grid, rx_grid, hour, month
band_openings	1 つのバンドにおける経路の時間ごとの伝搬プロファイル	tx_grid, rx_grid, band
path_analysis	すべてのバンド、時刻、月、ソースにわたる経路解析	tx_grid, rx_grid, source
solar_correlation	SFI 区分別の太陽フラックスによる伝搬への影響	band, tx_grid, rx_grid
grid_info	太陽高度を含むメイデンヘッドグリッドのデコード	grid, hour, month
compare_sources	データセット間の比較（WSPR、RBN、コンテスト、PSKR）	tx_grid, rx_grid, band
dark_hour_analysis	太陽の位置関係別の経路分析：両地点が昼、ターミネーター横断、両地点が夜	band, hour, month
solar_history	指定期間の過去の太陽指数	start_date, end_date, resolution
band_summary	バンドの概要：時刻分布、グリッドペア上位、距離	band, source
current_conditions	最新予報：SFI、Kp、太陽風、バンドの見通し、POTA/SOTA のヒント	qth_grid
get_version_info	サービスのバージョンと上流仕様のバージョン（フリートの識別情報の証明）	—

IONIS-AI とは？

IONIS-AI は、HF（短波）無線伝搬を予測するオープンソースの機械学習システムです。世界最大のアマチュア無線テレメトリーネットワークから厳選したデータセットを、SourceForge で SQLite ファイルとして配布しています。ionis-mcp を使えば、SQL を使わずにアシスタントがこれらのデータから伝搬に関する質問に回答できます。

ソース	シグネチャ数	生の観測データ	SNR の種類	年
WSPR	93.6M	109 億件のビーコンスポット	実測（-30～+20 dB）	2008-2026
RBN	67.3M	23 億件の CW/RTTY スポット	実測（8～29 dB）	2009-2026
CQ コンテスト	5.7M	2 億 3,400 万件の SSB/RTTY QSO	基準値（+10/0 dB）	2005-2025
DX ペディション	260K	390 万件の希少グリッド間経路	実測	2009-2025
PSK Reporter	8.4M	5 億 1,400 万件以上の FT8/WSPR スポット	実測（-34～+38 dB）	2026 年 2 月以降
太陽指数	—	7 万 7,000 件の日次／3 時間ごとの記録	SFI、SSN、Kp、Ap	2000-2026
DSCOVR L1	—	2 万 3,000 件の太陽風サンプル	Bz、速度、密度	2026 年 2 月以降

すべてのシグネチャテーブルは、同一の 13 列スキーマ（tx_grid、rx_grid、band、hour、month、median_snr、spot_count、snr_std、reliability、avg_sfi、avg_kp、avg_distance、avg_azimuth）を共有しており、ソースをまたいだ分析にすぐ使用できます。

データセット

# 1. Install
uv tool install ionis-mcp

# 2. Download datasets (to default location: ~/.ionis-mcp/data/)
ionis-download --bundle minimal          # 454 MB  — contest + solar + grids
ionis-download --bundle recommended      # 1.1 GB  — adds PSKR + DSCOVR
ionis-download --bundle full             # 16.2 GB — all 9 datasets

# 3. Configure your MCP client (see Quick Start) and restart

以上です。ionis-download と ionis-mcp は同じ既定のデータディレクトリを使用します。環境変数は不要です。

デフォルトのデータディレクトリ

プラットフォーム	場所
Linux / macOS	~/.ionis-mcp/data/
Windows	%LOCALAPPDATA%\ionis-mcp\data\

カスタムパスで上書きできます：

# Download to custom location
ionis-download --bundle minimal /path/to/my/data

# Tell the server where to find it
ionis-mcp --data-dir /path/to/my/data
# or
export IONIS_DATA_DIR=/path/to/my/data

個別のデータセットをダウンロードする

# Pick specific datasets
ionis-download --datasets wspr,rbn,grids,solar

# See all available datasets and bundles
ionis-download --list

# Re-download (overwrite existing)
ionis-download --bundle minimal --force

ダウンロードが中断された場合（接続の切断や Ctrl-C など）は、同じコマンドをもう一度実行してください。中断したところから再開します。一時的なネットワークエラーは自動的に再試行されます。サイズの単位は MB と GB です（1 MB = 1,000,000 bytes）。

データディレクトリの構成

~/.ionis-mcp/data/                  (or $IONIS_DATA_DIR)
├── propagation/
│   ├── wspr-signatures/wspr_signatures_v2.sqlite      (9.1 GB, 93.6M rows)
│   ├── rbn-signatures/rbn_signatures.sqlite            (6.0 GB, 67.3M rows)
│   ├── contest-signatures/contest_signatures.sqlite    (445 MB, 5.7M rows)
│   ├── dxpedition-signatures/dxpedition_signatures.sqlite (22 MB, 260K rows)
│   └── pskr-signatures/pskr_signatures.sqlite          (635 MB, 8.4M rows)
├── solar/
│   ├── solar-indices/solar_indices.sqlite               (8.0 MB, 76.7K rows)
│   └── dscovr/dscovr_l1.sqlite                         (3.0 MB, 23K rows)
└── tools/
    ├── grid-lookup/grid_lookup.sqlite                   (1.1 MB, 31.7K rows)
    └── balloon-callsigns/balloon_callsigns_v2.sqlite    (0.1 MB, 1.5K rows)

サーバーは、存在するデータセットを使って動作します。データセットが見つからない場合でも適切に対処されます。利用できないデータを必要とするツールは、エラーではなく明確なメッセージを返します。

クイックスタート

MCP クライアントを設定する

ionis-mcp は、MCP 互換のあらゆるクライアントで動作します。サーバー設定を追加して再起動してください。ツールは自動的に表示されます。

データをカスタムの場所にダウンロードした場合は、以下のいずれかの設定に "env": { "IONIS_DATA_DIR": "/path/to/data" } を追加してください。

Claude Desktop

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

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

Claude Code

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

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

ChatGPT Desktop

ChatGPT は OpenAI Agents SDK を介して MCP をサポートしています。Settings > Apps & Connectors で追加するか、エージェント定義で設定してください：

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

Cursor

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

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

VS Code / GitHub Copilot

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

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

Gemini CLI

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

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

pip でインストールした場合は、上記いずれかの設定で "command": "ionis-mcp" を使用してください。

質問する

「アイダホからヨーロッパへの 20m の通信可能時間はいつですか？」

「太陽フラックスは 15m の伝搬にどのような影響を与えますか？」

「両局が暗闇にある 03z の 10m の経路を表示してください」

「20m FN31 から JO51 への WSPR と RBN の観測結果を比較してください」

「現在のバンドコンディションはどうですか？ POTA に出かけるところです。」

「2026 年 2 月の地磁気嵐の間、太陽の状態はどうでしたか？」

アーキテクチャ

• トランスポート：stdio（Claude Desktop / Claude Code）または streamable-http（MCP Inspector）
• データベース：読み取り専用の sqlite3 接続（?mode=ro）— 書き込みは一切行いません
• クエリの安全性：すべてのクエリでパラメーター化 SQL（? プレースホルダー）を使用し、結果数はサーバー側で制限されます（最大 1000 行）
• グリッド検索：31.7K 件の Maidenhead グリッドを起動時にメモリへ読み込み（約 2 MB）、緯度・経度を即座に解決します
• 太陽ジオメトリ：純粋な Python による太陽高度の計算（IONIS-AI のトレーニングパイプラインと同じアルゴリズム）— 伝搬の状況を把握するため、各端点を昼・薄明・夜に分類します
• 複数ソースのクエリ：各 SQLite データベースを個別に開き、Python でソースラベルを付けて結果を統合します

MCP Inspector

ionis-mcp --transport streamable-http --port 8000

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

開発

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

関連プロジェクト

リポジトリ	目的
ionis-validate	IONIS-AI モデル検証スイート（PyPI）
IONIS-AI datasets	配布データセットファイル（SourceForge）

ライセンス

GPL-3.0-or-later

引用

研究で IONIS-AI データセットを使用する場合は、以下を引用してください：

Beam, G. (KI7MT). IONIS: Ionospheric Neural Inference System — HF Propagation Prediction Datasets. SourceForge, 2026. https://sourceforge.net/projects/ionis-ai/