Iota Mcp

io.github.qso-graph由 GitHub 帳號 qso-graph 發布v0.4.1更新於 Nov 3, 2026

Islands on the Air MCP server. Group lookup, island search, DXCC mapping, nearby groups.

已驗證STDIO僅桌面位置與生活知識與記憶

概覽

AI 產生的概覽

唯讀的 Islands on the Air(IOTA)資料 MCP 伺服器,提供群組查詢、島嶼搜尋、DXCC 對應、鄰近群組與計畫統計。

可以做什麼
  • 依參考編號查詢 IOTA 群組,回傳名稱、DXCC 實體、邊界框、中心座標、認可百分比與島嶼數量
  • 依名稱搜尋 IOTA 群組與島嶼,結果依參考編號去重
  • 列出某個群組下的完整子群組與島嶼階層
  • 在 DXCC 實體與 IOTA 群組之間雙向對應
  • 依經緯度計算大圓距離,找出最近的 IOTA 群組
  • 提供計畫統計,並查詢服務版本與上游資料版本
適用情境
適合業餘無線電玩家與獎項追逐者,讓助理回答 IOTA 參考編號、DXCC 對應、某群組包含哪些島嶼,或某地點附近有哪些 IOTA 群組等問題。
執行需求
以 stdio 本機程序執行,透過 uvx 從 iota-mcp 的 PyPI 套件啟動,需要 Python/uv 執行環境。無需驗證或憑證。需要網路連線下載公開的 IOTA JSON 資料,資料快取 24 小時;另提供離線測試用的模擬模式。
安裝前請注意
僅做唯讀查詢,不寫入資料,除取得公開的 IOTA 資料檔外不向第三方傳送資料。資料快取 24 小時,結果可能落後於上游每日更新。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Iota Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

iota-mcp

[PyPI] [MCP Registry]

MCP server for Islands on the Air (IOTA) — group lookup, island search, DXCC mapping, nearby groups, and programme statistics through any MCP-compatible AI assistant.

Part of the qso-graph project. No authentication required — all IOTA data is public.

Install

bash
uvx iota-mcp            # run it; nothing to install

Tools

ToolDescription
iota_lookupLook up an IOTA group by reference number (e.g., NA-005)
iota_searchSearch groups and islands by name (e.g., Hawaii, Shetland)
iota_islandsList all islands and subgroups in an IOTA group
iota_dxccBidirectional DXCC-to-IOTA mapping
iota_statsProgramme summary — totals by continent, most/least credited
iota_nearbyFind IOTA groups nearest to a lat/lon location
get_version_infoService version + upstream programme data version (fleet identity attestation)

Quick Start

No credentials needed — just install and configure your MCP client.

Configure your MCP client

iota-mcp works with any MCP-compatible client. Add the server config and restart — tools appear automatically.

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

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

Add to .claude/settings.json:

json
{  "mcpServers": {    "iota": {      "command": "uvx",      "args": ["iota-mcp"]    }  }}
ChatGPT Desktop
json
{  "mcpServers": {    "iota": {      "command": "uvx",      "args": ["iota-mcp"]    }  }}
Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

json
{  "mcpServers": {    "iota": {      "command": "uvx",      "args": ["iota-mcp"]    }  }}
VS Code / GitHub Copilot

Add to .vscode/mcp.json in your workspace:

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

Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):

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

Ask questions

"Look up IOTA group NA-005"

"Search for islands named Shetland"

"What IOTA groups are near Boise, Idaho?"

"Show me all islands in EU-005"

"What IOTA references map to DXCC 291?"

"Give me IOTA programme statistics"

Data Source

Data comes from the official IOTA website JSON downloads:

  • fulllist.json — complete group/subgroup/island hierarchy (~1.3 MB)
  • dxcc_matches_one_iota.json — 1:1 DXCC-to-IOTA mapping (~3.5 KB)

Data is downloaded once and cached for 24 hours (IOTA refreshes daily at 00:00 UTC).

Testing Without Network

bash
IOTA_MCP_MOCK=1 iota-mcp

MCP Inspector

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

Then open the MCP Inspector at http://localhost:8010.

Development

bash
git clone https://github.com/qso-graph/iota-mcp.gitcd iota-mcpuv sync --group devuv run pytest

License

GPL-3.0-or-later

來源:README.md,提交 a3694fd

工具

7

get_version_info

Get Version Info

Get iota-mcp service version and upstream programme data version. Returns the running PyPI version of iota-mcp and the IOTA programme data revision in use. Use this to confirm fleet alignment across MCP deployments — agents can compare service_version and spec_version across servers to detect drift without going outside the MCP protocol.

無需輸入參數。

iota_lookup

Iota Lookup

Look up an IOTA group by reference number. Returns group details including name, DXCC entity, bounding box, center coordinates, credit percentage, and island count.

輸入參數refno必填

iota_islands

Iota Islands

List all islands and subgroups in an IOTA group. Returns the full hierarchy: subgroups containing individual islands.

輸入參數refno必填

iota_dxcc

Iota Dxcc

Bidirectional DXCC-to-IOTA mapping. Provide either dxcc_num to find all IOTA groups for a DXCC entity, or refno to find which DXCC entities an IOTA group belongs to.

輸入參數refnodxcc_num

iota_stats

Iota Stats

Get IOTA programme summary statistics. Returns total groups and islands, breakdown by continent, DXCC entity count, and most/least credited groups.

無需輸入參數。

iota_nearby

Iota Nearby

Find IOTA groups nearest to a location. Computes great-circle distance from the given coordinates to the center of each IOTA group's bounding box.

輸入參數limitlatitude必填longitude必填

版本歷史

10
  1. v0.4.1最新Oct 29, 2026
  2. v0.3.0Oct 26, 2026
  3. v0.2.3Oct 26, 2026
  4. v0.2.1Oct 26, 2026
  5. v0.2.0Oct 12, 2026
  6. v0.1.6Oct 11, 2026
  7. v0.1.5Oct 7, 2026
  8. v0.1.4Oct 6, 2026
  9. v0.1.3Sep 29, 2026
  10. v0.1.0Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分