IOTA MCP Server

IOTA MCP 服务

一款功能全面的模型上下文协议（MCP）服务，为 IOTA 和多个兼容 EVM 的网络提供区块链服务。该服务让 AI Agent 能够通过统一接口与 IOTA、Shimmer、Ethereum、Optimism、Arbitrum、Base、Polygon 及其他众多 EVM 链交互。

📋 目录

• 概览
• 功能
• IOTA 集成
• 支持的网络
• 前提条件
• 安装
• 服务配置
• 使用方法
• 交互式演示
• API 参考
  • IOTA 工具
  • 套利工具
  • IOTA 资源
• 安全注意事项
• 项目结构
• 开发
• 许可证

🏆 IOTA APAC AngelHack 2025 参赛项目

本项目是为 IOTA APAC AngelHack 2025 黑客松开发的参赛作品，旨在通过模型上下文协议（MCP）增强 IOTA 网络与 AI 系统之间的集成。

黑客松赛道

• 主赛道：AI Agent
• 次要赛道：开发者工具
• 其他赛道：跨链

🔭 概览

IOTA MCP 服务利用模型上下文协议为 AI Agent 提供区块链服务，尤其专注于 IOTA 及其生态系统。它支持多种服务，包括：

• 读取区块链状态（余额、交易、区块等）
• 与智能合约交互
• 转移代币（原生代币、ERC20、ERC721、ERC1155）
• IOTA 专属服务（质押、网络状态、Gas 估算等）
• 查询代币元数据和余额
• 提供覆盖 30 多个 EVM 网络（包括 IOTA 网络）的链专属服务
• ENS 名称解析，适用于所有地址参数（使用易读名称代替地址）

所有服务均通过统一的 MCP 工具和资源接口提供，使 AI Agent 能够轻松发现并使用多个网络（包括 IOTA、Shimmer 及所有其他兼容 EVM 的链）上的区块链功能。

✨ 功能

IOTA 专属功能

• IOTA 网络支持，涵盖 IOTA EVM、IOTA Testnet 和 Shimmer 网络
• IOTA 代币信息，包括名称、符号、小数位数和总供应量
• IOTA 网络指标，包括 TPS、区块时间、Gas 用量等
• IOTA 网络状态监控和运行状况检查
• IOTA 余额查询，用于查看原生代币余额
• IOTA 交易分析，包括 Gas 用量、类型检测和交易时长分析
• IOTA 智能合约部署，可直接部署 Solidity 合约
• IOTA 智能合约分析，包括函数检测、标准验证和安全评估
• IOTA DeFi 集成，支持流动性池、借贷市场和质押
• IOTA 质押信息，用于监控质押活动
• IOTA 交易历史和分析
• Gas 价格估算，包括网络拥堵分析和交易成本预测
• 跨链套利监控，用于发现 IOTA 与其他网络之间有利可图的交易机会
• 跨链对比，比较 IOTA 与其他网络

区块链数据访问

• 多链支持，覆盖包括 IOTA 在内的 30 多个兼容 EVM 的网络
• 链信息，包括 blockNumber、chainId 和 RPC
• 按区块编号、哈希或最新区块访问区块数据
• 交易详情和包含已解码日志的收据
• 地址余额，涵盖原生代币和所有代币标准
• ENS 解析，将以太坊地址转换为易读形式

代币服务

• ERC20 代币

  • 获取代币元数据（名称、符号、小数位数、供应量）
  • 查询代币余额
  • 在地址之间转移代币
  • 批准支出额度

• NFT（ERC721）

  • 获取集合和代币元数据
  • 验证代币所有权
  • 在地址之间转移 NFT
  • 获取代币 URI 和持有数量

• 多代币（ERC1155）

  • 获取代币余额和元数据
  • 按数量转移代币
  • 访问代币 URI

智能合约交互

• 通过 view/pure 函数读取合约状态
• 使用私钥签名的写入服务
• 合约验证，用于区分合约与 EOA
• 获取和筛选事件日志

🌐 支持的网络

IOTA 网络

• IOTA EVM 主网
• IOTA 测试网
• Shimmer

主网

• Ethereum (ETH)
• Optimism (OP)
• Arbitrum (ARB)
• Arbitrum Nova
• Base
• Polygon (MATIC)
• Polygon zkEVM
• Avalanche (AVAX)
• Binance Smart Chain (BSC)
• zkSync Era
• Linea
• Celo
• Gnosis (xDai)
• Fantom (FTM)
• Filecoin (FIL)
• Moonbeam
• Moonriver
• Cronos
• Scroll
• Mantle
• Manta
• Blast
• Fraxtal
• Mode
• Metis
• Kroma
• Zora
• Aurora
• Canto
• 以及更多……

测试网

• Sepolia
• Optimism Sepolia
• Arbitrum Sepolia
• Base Sepolia
• Polygon Amoy
• 以及更多……

🛠️ 前提条件

• Bun 1.0.0 或更高版本
• Node.js 18.0.0 或更高版本（如果不使用 Bun）

📦 安装

克隆仓库

首先，将仓库克隆到本地计算机：

git clone https://github.com/Danielmark001/iota_evm_mcp_server.git
cd iota_evm_mcp_server

安装依赖项

使用 Bun（推荐）：

bun install

使用 npm：

npm install

环境设置

1. 复制示例环境文件：

cp .env.example .env

2. 根据你的配置更新 .env 文件：

# Server Configuration
PORT=3001
HOST=0.0.0.0
DEFAULT_CHAIN_ID=1074  # IOTA EVM Mainnet

# IOTA Configuration
IOTA_JWT_TOKEN=your_jwt_token_here
IOTA_NODE_URL=https://api.iota.org
IOTA_MNEMONIC=your_mnemonic_here  # Required for sending transactions

# SSL Configuration (optional for development)
SSL_CERT_PATH=./certs/client.crt
SSL_KEY_PATH=./certs/client.key
SSL_CA_PATH=./certs/iota-root-ca.crt

⚙️ 配置

服务使用以下默认配置，可在 .env 文件中调整：

# Create a .env file in the root directory
touch .env

# Add configuration values
echo "PORT=3001" >> .env
echo "HOST=0.0.0.0" >> .env
echo "DEFAULT_CHAIN_ID=1074" >> .env  # IOTA EVM Mainnet

🚀 使用方法

启动服务

使用 stdio（用于嵌入命令行工具）

# Start the server
bun start

# Development mode with auto-reload
bun dev

使用 HTTP 服务（用于 Web 应用）

# Start the HTTP server
bun start:http

# Development mode with auto-reload
bun dev:http

构建生产版本

# Build the project
bun run build

# Build the HTTP server
bun run build:http

Docker 部署

# Build the Docker image
docker build -t iota_evm_mcp_server .

# Run the container
docker run -p 3001:3001 iota_evm_mcp_server

🔌 与 AI 系统集成

交互式演示

本项目提供了一个可视化演示界面，展示 Claude 或其他 AI 助手如何与 IOTA 区块链数据交互。演示内容包括：

1. 网络状态分析 - 展示 AI 如何分析当前 IOTA 网络状况和 Gas 价格
2. 跨链套利 - 演示如何监控 IOTA 与其他网络之间的价格差异
3. 智能合约部署 - 展示 AI 如何指导用户优化智能合约部署

运行演示：

# Install demo dependencies
npm run demo:install

# Start both the MCP server and demo interface
npm run demo:start

# For development with hot-reloading
npm run demo:dev

然后在浏览器中打开 http://localhost:3006

示例：与 Claude、GPT-4 或其他 AI 助手搭配使用

支持模型上下文协议的 AI 平台可以直接连接到 IOTA MCP Server。例如，使用配置妥当且支持 MCP 的 AI：

User: "Check the balance of address 0x1234... on the IOTA network"

AI Assistant: [Uses IOTA MCP Server to check balance and returns]
"The balance of address 0x1234... on the IOTA network is 15.75 MIOTA"

示例：将服务与自定义 AI Agent 搭配使用

// Connect to MCP server
const mcpClient = new McpClient({
  endpoint: "http://localhost:3001",
});

// Call IOTA-specific tool
const response = await mcpClient.callTool("get_iota_balance", {
  address: "0x1234...",
  network: "iota",
});

console.log(response);

📚 API 参考

该服务提供了一套全面的工具和资源，用于与 IOTA 及其他区块链网络交互。如需详细的 API 文档，请参阅 API 参考。

关键 IOTA 工具

• get_iota_network_info：获取 IOTA 网络信息
• get_iota_balance：获取某个地址的代币余额
• transfer_iota：向另一个地址转移 IOTA 代币
• get_iota_staking_info：获取质押信息
• verify_iota_network_status：检查网络健康状况和状态
• get_iota_gas_prices：获取当前 Gas 价格及网络拥堵分析
• estimate_iota_transaction_cost：估算不同速度选项下的交易成本
• deploy_iota_smart_contract：将 Solidity 智能合约部署到 IOTA 网络
• analyze_iota_smart_contract：对已部署的智能合约进行安全分析

套利工具

• get_cross_chain_token_price：获取包括 IOTA 在内的不同网络上的代币价格
• find_arbitrage_opportunities：检测 IOTA 与其他链之间的盈利交易机会
• list_arbitrage_tokens：查看可供套利监控的所有代币

关键 IOTA 资源

• iota://{network}/info：IOTA 网络信息
• iota://{network}/block/latest：IOTA 网络上的最新区块
• iota://{network}/address/{address}/balance：某个地址的代币余额
• iota://{network}/status：网络健康状况和状态

🧪 测试

运行测试套件：

# Using Bun (recommended)
bun test

# Using npm
npm test

运行指定的测试文件：

bun test test/iota-defi-agent.test.ts

🤝 贡献

欢迎贡献！欢迎提交 Pull Request。

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 提交 Pull Request

请务必根据需要更新测试，并遵循我们的行为准则。

🐛 故障排除

常见问题

1. Node 版本错误

   • 确保已安装 Node.js 18.0.0 或更高版本
   • 使用 nvm 管理 Node.js 版本

2. Bun 安装问题

   • 按照官方 Bun 安装指南
   • 遇到问题时，尝试重新安装 Bun

3. IOTA 连接问题

   • 确认 IOTA 节点 URL 正确
   • 检查 JWT 令牌是否有效
   • 确保网络连接稳定

4. 构建错误

   • 运行 bun install 确保安装了所有依赖项
   • 清除构建目录：rm -rf build/
   • 检查 tsconfig.json 中的 TypeScript 配置

获取帮助

• 在 GitHub 上提交问题
• 查看我们的 常见问题

📝 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

🙏 致谢

• 感谢 IOTA Foundation 提供卓越的技术
• 感谢 Model Context Protocol 支持 AI 与区块链交互
• 感谢 Viem 提供 EVM 交互库
• 感谢 IOTA APAC AngelHack 2025 的组织者和导师
• 感谢所有贡献者和支持者

---

用 ❤️ 为 IOTA 社区打造