JinDaGe - iota_evm_mcp_server MCP Details

article

README

🚀 IOTA 网络 MCP 服务器

IOTA 网络 MCP 服务器是一款基于 Model Context Protocol（模型上下文协议）构建的工具，它能够将人工智能与区块链网络（尤其是 IOTA 网络）连接起来。该服务器具备丰富的接口和功能，可支持对 IOTA 网络进行操作、分析和交互。

🚀 快速开始

IOTA 网络 MCP 服务器提供了便捷的方式让您快速接入并使用 IOTA 网络。按照以下步骤操作，即可开启您的使用之旅。

✨ 主要特性

核心功能

IOTA 网络交互：支持 IOTA 网络的基本操作，包括地址余额查询、交易广播等。
智能合约部署与分析：提供 Solidity 智能合约的部署和安全分析工具。
跨链仲裁工具：帮助检测跨链套利机会，并监控 arbitrage tokens（套利代币）。
网络状态监控：实时获取 IOTA 网络的健康状况和最新区块信息。

关键工具

get_iota_network_info：获取 IOTA 网络的基本信息。
transfer_iota：向指定地址转移 IOTA 代币。
deploy_iota_smart_contract：在 IOTA 网络上部署 Solidity 智能合约。
analyze_iota_smart_contract：对已部署的智能合约进行安全分析。

📦 安装指南

安装依赖

# 使用 Bun（推荐）
bun install

# 使用 npm
npm install

启动服务

bun dev

配置文件

将以下内容添加到 config.json 文件中：

{
  "iotaNodeUrl": "https://nodes.iota.org",
  "jwtToken": "your_jwt_token_here",
  "network": "mainnet"
}

💻 使用示例

基础用法

// 连接 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 参考

核心接口

get_iota_balance(address: string, network: string): 获取指定地址的 IOTA 代币余额。
transfer_iota(fromAddress: string, toAddress: string, amount: number, network: string): 向指定地址转移 IOTA 代币。
deploy_iota_smart_contract(contractCode: string, network: string): 在 IOTA 网络上部署 Solidity 智能合约。

跨链仲裁工具

find_arbitrage_opportunities(): 检测跨链套利机会。
list_arbitrage_tokens(): 获取所有支持的套利代币列表。

项目结构

iota-mcp-server/
├── src/                 # 源代码文件夹
│   ├── agents/          # IOTA 定制代理
│   ├── tools/           # 核心工具模块
│   └── config.ts        # 配置管理文件
├── bin/                # 可执行脚本文件
├── package.json       # 依赖管理文件
└── README.md          # 项目文档文件

贡献指南

创建功能分支

git checkout -b feature/amazing-feature

提交代码

git add .
git commit -m "添加新功能：Amazing Feature"
git push origin feature/amazing-feature

发起拉取请求

测试指南

运行测试

bun test

覆盖测试

bun test --coverage

项目联系

作者：IOTA 团队
邮箱：contact@iota.org
GitHub：https://github.com/IOTA-MCP

感谢您对 IOTA 网络 MCP 服务器的支持！

iota_evm_mcp_server