MCP EVM Signer

MCP EVM 签名器

用于管理 Ethereum 私钥并通过 Infura 部署智能合约的模型上下文协议（MCP）服务。此服务可让 Claude for Desktop 和其他 MCP 客户端与兼容 EVM 的区块链交互。

功能

• 🔑 在本地安全地存储和管理 Ethereum 私钥
• 🔌 连接到 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": {
    "evm-signer": {
      "command": "node",
      "args": ["/path/to/mcp-evm-signer/build/index.js"],
      "env": {
        "INFURA_API_KEY": "your_infura_api_key_here",
        "DEFAULT_NETWORK": "sepolia",
        "ENCRYPT_KEYS": "true",
        "KEY_PASSWORD": "your_secure_password_here"
      }
    }
  }
}

2. 重启 Claude for Desktop

3. 现在可以让 Claude 部署智能合约、检查余额或与 EVM 区块链交互

可用工具

MCP EVM 签名器服务提供以下工具，供 Claude 使用：

钱包管理

• create-wallet：创建新的 Ethereum 钱包
• import-wallet：通过私钥导入现有钱包
• list-wallets：列出所有已保存的钱包

区块链操作

• check-balance：检查某个地址的 ETH 余额
• get-transactions：获取某个地址的近期交易
• send-transaction：向某个地址发送 ETH

智能合约交互

• deploy-contract：根据 ABI 和字节码部署智能合约
• call-contract：调用只读合约方法
• execute-contract：执行会修改状态的合约方法

使用示例

以下是使用这些工具与 Claude 交互的一些示例：

创建钱包

你可以向 Claude 提出请求：

Could you create a new Ethereum wallet for me using the evm-signer tools?

查看余额

你可以向 Claude 提出请求：

Can you check the balance of my Ethereum wallet 0x1234...5678 on the Sepolia network?

部署 ERC-20 代币

请参阅我们的 ERC-20 代币示例，了解部署和交互 ERC-20 代币合约的完整步骤。

安全说明

• 私钥存储在你的本地计算机上
• 可以使用密码加密密钥
• 此服务仅通过 MCP 协议提供功能
• 在 Claude for Desktop 中批准交易前，请务必先检查交易
• 初次使用时，请使用 Sepolia 或 Goerli 等测试网络

文档

如需更详细的文档，请参阅：

• 使用指南：详细的使用说明和示例
• 示例：工作流和合约部署示例

项目结构

mcp-evm-signer/
├── src/                  # Source code
│   ├── config.ts         # Configuration management
│   ├── crypto.ts         # Key management utilities
│   ├── ethereum.ts       # Ethereum interaction functions
│   └── index.ts          # Main MCP server implementation
├── keys/                 # Storage for wallet keys (gitignored)
├── examples/             # Example usage patterns
├── .env.example          # Example environment variables
└── ...                   # Project configuration files

开发

如需为此项目做出贡献：

1. Fork 此代码库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 进行修改
4. 提交修改（git commit -m 'Add some amazing feature'）
5. 推送到分支（git push origin feature/amazing-feature）
6. 发起 Pull Request

许可证

本项目采用 MIT License 授权；详情请参阅 LICENSE 文件。