](https://mseep.ai/app/danielmark001-iota-evm-mcp-server)
IOTA MCP服务器
一个全面的模型上下文协议（MCP）服务器，为IOTA和多个EVM兼容网络提供区块链服务。该服务器使AI代理能够通过统一的接口与IOTA、Shimmer、以太坊、Optimism、Arbitrum、Base、Polygon和许多其他EVM链进行交互。
📋 目录
🏆 IOTA亚太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、阻塞时间、天然气使用量等。
- IOTA网络状态 监测和健康检查
- IOTA余额查询 用于检查本地令牌余额
- IOTA交易分析 具有气体使用、类型检测和年龄分析功能
- IOTA智能合约部署 用于直接部署Solidity合同
- IOTA智能合约分析 具有功能检测、标准验证和安全评估
- IOTA DeFi集成 流动性池、贷款市场和质押
- IOTA质押信息 用于监控打桩活动
- IOTA交易历史 分析
- 天然气价格估算 基于网络拥塞分析和交易成本预测
- 跨链套利监控 用于检测IOTA和其他网络之间的盈利交易机会
- 跨链比较 IOTA和其他网络之间
区块链数据访问
- 多链支持 适用于包括IOTA在内的30+EVM兼容网络
- 链信息 包括blockNumber、chainId和RPC
- 块数据 按数字、哈希值或最新值访问
- 交易详情 以及带有解码日志的收据
- 地址余额 适用于本地令牌和所有令牌标准
- ENS分辨率 用于人类可读的以太坊地址
代币服务
- ERC20代币
- 获取令牌元数据（名称、符号、小数、供应） - 检查代币余额 - 在地址之间转移令牌 - 批准支出津贴
- NFT（ERC721）
- 获取集合和令牌元数据 - 验证令牌所有权 - 在地址之间传输NFT - 检索令牌URI并统计持有量
- 多代币（ERC1155）
- 获取令牌余额和元数据 - 按数量转移代币 - 访问令牌URI
智能合约交互
- 读取合同状态 通过视图/纯函数
- 写服务 使用私钥签名
- 合同验证 区别于EOA
- 事件日志 检索和过滤
🌐 支持的网络
IOTA网络
- IOTA EVM主网
- IOTA测试网
- 微光
主网络
- 以太坊（ETH）
- 乐观主义（OP）
- 仲裁（ARB）
- 仲裁 新
- 基础
- 多边形（MATIC）
- 多边形zkEVM
- 雪崩（AVAX）
- 币安智能链（BSC）
- Zksync时代
- 流线
- Celo
- 诺斯替语（xDai）
- 芬托姆（FTM）
- Filecoin（FIL）
- 月光
- 月亮河
- 克罗诺斯
- 滚动
- 地幔
- 蝠鲼
- 爆炸
- 弗拉克斯塔尔
- 模式
- 梅蒂人
- 克罗马
- 佐拉
- 极光
- 坎托
- 还有更多。..
测试网
- Sepolia
- 乐观Sepolia
- 杨梅
- 基础Sepolia
- 多边形淘
- 还有更多。..
🛠️ 先决条件
- 包子 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环境设置
- 复制示例环境文件：
cp .env.example .env- 更新
.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（用于嵌入CLI工具）
# 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:httpDocker部署
# 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或其他人工智能助手如何与IOTA区块链数据交互。演示功能：
- 网络状态分析 -展示人工智能如何分析当前IOTA网络状况和天然气价格
- 跨链套利 -展示对IOTA和其他网络之间价格差异的监控
- 智能合约部署 -展示最佳智能合约部署的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服务器。例如，使用正确配置的启用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代理的服务器
// 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：通过网络拥堵分析获取当前天然气价格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🤝 贡献
欢迎投稿！请随时提交拉取请求。
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
请确保酌情更新测试并遵守我们的行为准则。
🐛 故障排除
常见问题
- 节点版本错误
- 确保您安装了Node.js 18.0.0或更高版本 - 使用 nvm 管理Node.js版本
- Bun安装问题
- 关注官方 丁腈橡胶安装指南 - 如果遇到问题，请尝试重新安装Bun
- IOTA连接问题
- 验证IOTA节点URL是否正确 - 检查您的JWT令牌是否有效 - 确保您的网络连接稳定
- 构建错误
- 跑 bun install 确保所有依赖项都已安装 - 清除生成目录： rm -rf build/ - 检查中的TypeScript配置 tsconfig.json
获取帮助
- 在GitHub上打开一个问题
- 查看我们的 常见问题解答
📝 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙏 致谢
______________________________________________________________________
内置于❤️ IOTA社区
