Iota Mcp

iota-mcp

面向 Islands on the Air (IOTA) 的 MCP 服务，可通过任何兼容 MCP 的 AI 助手查询群组、搜索岛屿、映射 DXCC、查找附近群组，以及查看计划统计数据。

这是 qso-graph 项目的一部分。无需身份验证——所有 IOTA 数据均为公开数据。

安装

uvx iota-mcp            # run it; nothing to install

工具

工具	描述
iota_lookup	按参考编号查询 IOTA 群组（例如 NA-005）
iota_search	按名称搜索群组和岛屿（例如 Hawaii、Shetland）
iota_islands	列出 IOTA 群组中的所有岛屿和子群组
iota_dxcc	DXCC 与 IOTA 的双向映射
iota_stats	计划概览——按大洲统计总数，以及获得最多／最少认可的项目
iota_nearby	查找距离给定经纬度位置最近的 IOTA 群组
get_version_info	服务版本 + 上游计划数据版本（集群身份验证）

快速开始

无需凭据——只需安装并配置 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 的岛屿”

“Boise, Idaho 附近有哪些 IOTA 群组？”

“显示 EU-005 中的所有岛屿”

“哪些 IOTA 参考编号对应 DXCC 291？”

“提供 IOTA 计划统计数据”

数据来源

数据来自 IOTA 官方网站的 JSON 下载文件：IOTA website：

• fulllist.json — 完整的群组／子群组／岛屿层级结构（约 1.3 MB）
• dxcc_matches_one_iota.json — DXCC 与 IOTA 的一对一映射（约 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