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 分