IOTA MCP服务器：钱包与智能合约管理

📌 Skill基础信息

Skill名称：iota-agent-mcp

简称：IOTA Agent MCP

来源：社区第三方（Scottcjn）

运行宿主：Claude Code、Cursor、VS Code Copilot

核心定位：为AI编程Agent提供与IOTA区块链交互的MCP服务，支持钱包管理、Move智能合约开发测试发布和链上数据查询功能，采用人机协同签名机制确保安全性。

🧩 内部核心组成

子Agent集合

无独立子Agent设计，所有功能通过单一MCP服务器提供

斜杠命令/MCP工具

命令名	功能简述
`iota_wallet_address`	获取活跃钱包地址
`iota_wallet_balance`	查询活跃钱包IOTA余额
`iota_wallet_accounts`	列出所有派生钱包账户
`iota_wallet_sign_execute`	签名并执行交易（需人工审批）
`iota_wallet_pending`	列出待审批的签名请求
`iota_wallet_approve`	按ID批准待处理签名请求
`iota_wallet_reject`	按ID拒绝待处理签名请求
`iota_wallet_switch_network`	切换主网/测试网/开发网
`iota_cli`	运行任意IOTA CLI命令
`iota_move_build`	编译Move包并报告构建结果
`iota_move_test_coverage`	运行Move测试并提供覆盖率分析
`iota_move_publish_unsigned`	生成待签名的发布交易
`iota_object`	按ID获取对象数据
`iota_objects_by_owner`	列出地址拥有的对象
`iota_transaction`	按摘要获取交易详情
`iota_coins`	获取代币对象用于Gas估算
`iota_epoch_info`	通过GraphQL获取纪元信息
`iota_decompile`	反编译已部署的Move模块ABI

模板文件

【无公开信息】

Hooks钩子

【无公开信息】

规则约束

钱包状态修改操作需人工审批（人机协同签名机制）
拒绝的交易不得在无明确指令情况下重试

目录结构

【无公开信息】

🛠 安装与启用方式

前置依赖：Node.js环境、npm包管理器

安装命令：

npm install -g iota-agent-mcp

配置方式：

Claude Code配置（~/.claude/settings.json）：

{
  "mcpServers": {
    "iota": { "command": "iota-agent-mcp" }
  }
}

Cursor/VS Code配置（.cursor/mcp.json或.vscode/mcp.json）：

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

环境变量配置：

IOTA_WALLET_SERVER：代理钱包服务器URL（默认：http://localhost:3847）
IOTA_RPC_URL：IOTA JSON-RPC端点（默认主网）
IOTA_GRAPHQL_URL：IOTA GraphQL索引器（默认主网）

📋 标准工作流

用户输入指令：通过AI Agent发起IOTA相关操作请求
链上查询：直接调用查询工具获取对象、交易、代币等信息
Move合约开发：使用构建、测试、覆盖率工具进行智能合约开发
交易签名流程：

- 生成无符号交易字节码

- 调用iota_wallet_sign_execute创建待审批请求

- 通过iota_wallet_pending确认请求状态

- 人工通过钱包服务器进行审批或拒绝

- 审批后验证交易是否上链

结果返回：将操作结果返回给用户

⚠️ 关键限制、缺陷、注意事项

平台限制：

仅支持配置了MCP服务器的AI Agent环境（Claude Code、Cursor、VS Code Copilot）
不支持非MCP兼容的AI开发工具

Token消耗：

链上查询操作消耗较少Token
合约编译和测试可能消耗较多计算资源
交易执行涉及Gas费用消耗

适合项目：

IOTA区块链智能合约开发
需要人机协同签名的安全敏感操作
链上数据查询和分析项目

不适合项目：

需要完全自动化无人工干预的交易场景
非IOTA生态的区块链开发
对实时性要求极高的高频交易

已知坑点：

人工审批环节可能引入延迟
需要额外配置钱包服务器
网络切换需手动操作

生产环境适用性：适合开发测试环境，生产环境使用需充分测试人工审批流程的可靠性和安全性。

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景：

IOTA Move智能合约开发者需要AI辅助编程
需要安全人机协同签名的钱包管理操作
链上数据查询和监控任务
智能合约的自动化测试和覆盖率分析
多网络环境（主网/测试网/开发网）切换开发

❌ 不适合场景：

需要完全自动化无需人工确认的交易场景
非IOTA区块链的开发项目
对交易延迟极其敏感的高频操作
无Node.js环境或无法安装npm包的系统
不支持MCP协议的AI编程工具

如何安装

skills install --user Scottcjn/iota-agent-mcp

通用安装教程：在哪里输入上面的命令

上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：

打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
把上面的安装命令复制进去，回车运行，等待下载与注册完成。
重启或重新加载 AI 工具，让新安装的 Skill 被识别。
新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。

Claude 桌面版（macOS / Windows）

桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。

Claude Code（终端 CLI）

直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。

VS Code（含 GitHub Copilot）

打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。

Cursor

底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。

Windsurf

底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。

其他工具（ChatGPT、本地脚本等）

不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。

风险提示

⚠️ 中风险：需留意隐私

本 Skill 涉及读取隐私 / 敏感信息（如密钥、环境变量、凭据）。安装前请确认其用途是否必要。

检测到隐私/敏感信息读取（预设模式 #4）

命中检测项

privacy_collect

IOTA MCP 服务器