Ethereum Transaction Builder

Transaction MCP Server

一个 MCP（Model Context Protocol）服务，提供全面的以太坊交易能力，包括针对传统交易和 EIP-1559 交易的构建、签名、解码与分析。

功能

工具（共 15 个）

交易构建与签名

• build_transaction - 构建未签名交易
• sign_transaction - 使用私钥签名交易
• build_and_sign_transaction - 一步完成构建与签名

交易解码

• decode_raw_transaction - 解码已签名的原始交易
• decode_unsigned_transaction - 解码未签名交易
• recover_transaction_signer - 从已签名交易中恢复签名者

交易分析

• estimate_transaction_cost - 估算以 ETH 计的 gas 成本
• validate_transaction - 校验交易字段
• compare_transactions - 比较两笔交易

Gas 工具

• convert_gas_units - 在 wei、gwei、ether 之间转换
• calculate_max_cost - 计算最大交易成本

数据编码

• encode_transfer - 编码 ERC-20 transfer calldata
• encode_function_call - 编码任意函数调用
• decode_calldata - 解码交易输入数据

序列化

• serialize_transaction - 对交易进行 RLP 编码

资源（共 4 个）

• transaction-types - 关于交易类型的文档（Legacy、EIP-2930、EIP-1559）
• gas-estimation - gas 估算与优化指南
• chain-ids - 所有网络的 Chain ID 参考
• eip-1559 - EIP-1559 费用机制详解

提示词（共 4 个）

• build_transfer_workflow - 引导完成 ETH 转账的构建
• token_transfer_workflow - 引导完成 ERC-20 代币转账
• decode_transaction_workflow - 帮助解码与分析交易
• gas_optimization_workflow - 优化交易 gas 成本

安装

pip install transaction-mcp-server

或从源码安装：

cd transaction-mcp-server
pip install -e .

用法

运行服务

transaction-mcp-server

在 Claude Desktop 中配置

{
  "mcpServers": {
    "transaction": {
      "command": "transaction-mcp-server"
    }
  }
}

工具示例

签名一笔简单转账

# Input
{
    "to": "0x742d35Cc6634C0532925a3b844Bc9e7595f5b4E2",
    "value": "1000000000000000000",  # 1 ETH in wei
    "nonce": 0,
    "chain_id": 1,
    "max_fee_per_gas": "30000000000",
    "max_priority_fee_per_gas": "2000000000",
    "private_key": "0x..."
}

# Output
{
    "raw_transaction": "0x02f8...",
    "transaction_hash": "0x...",
    "from": "0xABC...",
    "to": "0x742...",
    "value_eth": "1.0",
    "type": "EIP-1559"
}

解码一笔交易

# Input
{
    "raw_transaction": "0x02f8..."
}

# Output
{
    "type": "EIP-1559 (Type 2)",
    "chain_id": 1,
    "nonce": 0,
    "to": "0x742...",
    "value_wei": "1000000000000000000",
    "value_eth": "1.0",
    "max_fee_per_gas_gwei": "30.0",
    "max_priority_fee_per_gas_gwei": "2.0"
}

交易类型

Type	EIP	Description
Legacy (0)	-	原始以太坊交易
Access List (1)	EIP-2930	带访问列表以节省 gas
Dynamic Fee (2)	EIP-1559	基础费 + 优先费模型

安全说明

1. 私钥绝不会被记录或持久化
2. 交易在离线状态下签名 - 无网络连接
3. 原始交易必须单独广播
4. 仅供教育与开发用途

Chain ID

Chain	ID
Ethereum Mainnet	1
Goerli	5
Sepolia	11155111
Polygon	137
Arbitrum One	42161
Optimism	10
Base	8453

许可证

MIT