MCP 以太坊签名器

一个模型上下文协议（MCP）服务器，用于管理以太坊私人密钥并使用 Infura 部署智能合约。该服务器使 Claude for Desktop 和其他 MCP 客户端能够与以太坊兼容的区块链进行交互。

功能

• 🔑 安全存储和管理本地的以太坊私人密钥
• 🔌 通过 Infura 连接以太坊区块链
• 📝 使用编译的 ABI 和字节码部署智能合约
• ✍️ 签署并发送交易
• 💰 查看账户余额和交易历史
• 🔍 查询区块链数据并与部署的合约交互

快速开始

先决条件

• Node.js v16 或更高版本
• 带 API 密钥的 Infura 账户
• 安装了 Claude for Desktop 应用程序

安装

1. 克隆此仓库：

   git clone https://github.com/zhangzhongnan928/mcp-evm-signer.git
   cd mcp-evm-signer
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 配置环境变量：

   cp .env.example .env
   

   编辑 .env 文件以添加您的 Infura API 密钥并配置其他设置。

与 Claude for Desktop 集成

1. 将服务器添加到您的 Claude for Desktop 配置中：

{
  "mcpServers": {
    "ethereumSigner": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "INFURA_PROJECT_ID": "your-infura-project-id"
      }
    }
  }
}

2. 启动 Claude 并使用新的 MCP 服务器。

功能概述

钱包管理

• create-wallet: 创建新钱包并保存其私钥到安全位置。
• import-wallet: 使用现有私钥导入钱包。
• list-wallets: 列出所有已导入的钱包。

区块链操作

• check-balance: 查询指定地址的以太坊余额。
• send-transaction: 发送交易到区块链，支持 ERC20 代币和 ETH 转账。
• deploy-contract: 部署新的智能合约到区块链。
• call-contract: 调用已部署的智能合约方法。

示例使用

1. 创建新钱包：

   npx mcp ethereumSigner create-wallet
   

2. 导入现有钱包：

   npx mcp ethereumSigner import-wallet --private-key "0x..."
   

3. 部署智能合约：

   npx mcp ethereumSigner deploy-contract --abi-path ./contract.abi --bytecode-path ./contract.bytecode
   

安全注意事项

• 私人密钥必须安全存储，避免泄露。
• 建议在测试网络（如 Rinkeby、Kovan）中进行开发和测试。
• 使用 HTTPS 保护所有 API 调用。

项目结构

mcp-evm-signer/
├── src/
│   ├── config.js       # 项目配置
│   ├── wallet.js      # 钱包管理功能
│   ├── blockchain.js  # 区块链交互逻辑
│   └── signer.js      # 签名器主逻辑
├── dist/
│   └── index.js      # 构建后的主入口文件
└── .env.example       # 示例环境变量配置

开发流程

1. Fork 项目仓库。
2. 创建功能分支：git checkout -b feature/new-feature。
3. 提交代码更改：git add . && git commit -m "your commit message"。
4. 推送分支并创建 Pull Request。

许可证

此项目采用 MIT 许可证，详细信息请参阅 LICENSE 文件。