Iota Mcp

iota-mcp

Islands on the Air (IOTA) 用の MCP サーバーです。グループ検索、島の検索、DXCC マッピング、近隣グループ、プログラム統計を、MCP 対応のあらゆる AI アシスタントから利用できます。

qso-graph プロジェクトの一部です。認証は不要です。IOTA のデータはすべて公開されています。

インストール

uvx iota-mcp            # run it; nothing to install

ツール

ツール	説明
iota_lookup	参照番号（例：NA-005）で IOTA グループを検索します
iota_search	名前（例：Hawaii、Shetland）でグループや島を検索します
iota_islands	IOTA グループ内のすべての島とサブグループを一覧表示します
iota_dxcc	DXCC と IOTA の双方向マッピング
iota_stats	プログラムの概要 — 大陸別の合計数、クレジット数が最多／最少の項目
iota_nearby	緯度／経度で指定した場所に最も近い IOTA グループを検索します
get_version_info	サービスのバージョンと上流のプログラムデータのバージョン（フリート ID の証明）

クイックスタート

認証情報は不要です。インストールして MCP クライアントを設定するだけです。

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

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

Claude Desktop

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

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

Claude Code

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

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

ChatGPT Desktop

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

Cursor

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

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

VS Code / GitHub Copilot

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

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

Gemini CLI

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

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

質問する

「IOTA グループ NA-005 を調べて」

「Shetland という名前の島を検索して」

「アイダホ州ボイシの近くにある IOTA グループは？」

「EU-005 にあるすべての島を表示して」

「DXCC 291 に対応する IOTA 参照番号は？」

「IOTA プログラムの統計を表示して」

データソース

データは IOTA 公式ウェブサイトの JSON ダウンロードファイルから取得します。

• fulllist.json — グループ／サブグループ／島の完全な階層（約 1.3 MB）
• dxcc_matches_one_iota.json — DXCC と IOTA の 1 対 1 マッピング（約 3.5 KB）

データは一度ダウンロードされ、24 時間キャッシュされます（IOTA は毎日 00:00 UTC に更新されます）。

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

IOTA_MCP_MOCK=1 iota-mcp

MCP Inspector

iota-mcp --transport streamable-http --port 8010

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

開発

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

ライセンス

GPL-3.0-or-later