IOTA MCP 服务器

一个全面的模型上下文协议 (MCP) 服务器，为 IOTA 和多个 EVM 兼容网络提供区块链服务。该服务器使 AI 代理能够通过统一的接口与 IOTA、Shimmer、以太坊、Optimism、Arbitrum、Base、Polygon 和许多其他 EVM 链进行交互。

📋 目录

• 概述
• 特性
• IOTA 集成
• 支持的网络
• 前提条件
• 安装
• 服务器配置
• 用法
• API 参考
  • IOTA 工具
  • IOTA 资源
  • 通用工具
  • 通用资源
• 安全注意事项
• 项目结构
• 开发
• 许可证

🏆 IOTA APAC AngelHack 2025 提交

该项目是作为 IOTA APAC AngelHack 2025 黑客马拉松的提交作品而开发的。它侧重于通过模型上下文协议 (MCP) 增强 IOTA 网络和 AI 系统之间的集成。

黑客马拉松赛道

• 主要: AI 代理
• 次要: 开发者工具
• 附加: 跨链

🔭 概述

IOTA MCP 服务器利用模型上下文协议为 AI 代理提供区块链服务，特别关注 IOTA 及其生态系统。它支持广泛的服务，包括：

• 读取区块链状态（余额、交易、区块等）
• 与智能合约交互
• 转移代币（原生、ERC20、ERC721、ERC1155）
• IOTA 特定服务（质押、网络状态等）
• 查询代币元数据和余额
• 跨 30 多个 EVM 网络的链特定服务，包括 IOTA 网络
• ENS 名称解析，适用于所有地址参数（使用人类可读的名称而不是地址）

所有服务都通过 MCP 工具和资源的一致接口公开，使 AI 代理可以轻松地发现和使用包括 IOTA、Shimmer 和所有其他 EVM 兼容链在内的多个网络的区块链功能。

✨ 特性

IOTA 特定特性

• IOTA 网络支持，适用于 IOTA EVM、IOTA 测试网和 Shimmer 网络
• IOTA 代币信息，包括名称、符号、小数位数和总供应量
• IOTA 网络指标，包括 TPS、区块时间、Gas 使用量等
• IOTA 网络状态监控和健康检查
• IOTA 余额查询，用于检查原生代币余额
• IOTA 交易分析，包括 Gas 使用量、类型检测和时间分析
• IOTA 智能合约分析，包括函数检测和标准验证
• IOTA DeFi 集成，适用于流动性池、借贷市场和质押
• IOTA 质押信息，用于监控质押活动
• IOTA 交易历史和分析
• IOTA 与其他网络之间的跨链比较

区块链数据访问

• 多链支持，适用于 30 多个 EVM 兼容网络，包括 IOTA
• 链信息，包括 blockNumber、chainId 和 RPC
• 区块数据访问，按编号、哈希或最新
• 交易详情和收据，带有解码后的日志
• 地址余额，适用于原生代币和所有代币标准
• ENS 解析，适用于人类可读的以太坊地址

代币服务

• ERC20 代币

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

• NFT (ERC721)

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

• 多代币 (ERC1155)

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

智能合约交互

• 读取合约状态，通过 view/pure 函数
• 写入服务，使用私钥签名
• 合约验证，以区分 EOA
• 事件日志检索和过滤

🌐 支持的网络

IOTA 网络

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

主网

• 以太坊 (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

⚙️ 配置

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

# 在根目录中创建一个 .env 文件
touch .env

# 添加配置值
echo "PORT=3001" >> .env
echo "HOST=0.0.0.0" >> .env
echo "DEFAULT_CHAIN_ID=1074" >> .env  # IOTA EVM 主网

🚀 用法

启动服务器

使用 stdio（用于嵌入 CLI 工具）

# 启动服务器
bun start

# 具有自动重新加载的开发模式
bun dev

使用 HTTP 服务器（用于 Web 应用程序）

# 启动 HTTP 服务器
bun start:http

# 具有自动重新加载的开发模式
bun dev:http

构建用于生产

# 构建项目
bun run build

# 构建 HTTP 服务器
bun run build:http

Docker 部署

# 构建 Docker 镜像
docker build -t iota_evm_mcp_server .

# 运行容器
docker run -p 3001:3001 iota_evm_mcp_server

🔌 与 AI 系统集成

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

支持模型上下文协议的 AI 平台可以直接连接到 IOTA MCP 服务器。例如，使用正确配置的启用 MCP 的 AI：

用户：“检查 IOTA 网络上地址 0x1234... 的余额”

AI 助手：[使用 IOTA MCP 服务器检查余额并返回]
“IOTA 网络上地址 0x1234... 的余额为 15.75 MIOTA”

示例：将服务器与自定义 AI 代理一起使用

// 连接到 MCP 服务器
const mcpClient = new McpClient({
  endpoint: "http://localhost:3001",
});

// 调用 IOTA 特定工具
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：检查网络健康状况和状态

关键 IOTA 资源

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

🧪 测试

运行测试套件以验证服务器功能：

bun test

运行特定的测试文件：

bun test test/iota.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

📜 许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。

🙏 致谢

• IOTA 基金会 感谢他们出色的技术
• 模型上下文协议 用于启用 AI-区块链交互
• Viem 用于 EVM 交互库
• IOTA APAC AngelHack 2025 组织者和导师
• 所有贡献者和支持者

---

用 ❤️ 为 IOTA 社区构建