MCP EVM 签名器

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

功能

• 🔑 安全地在本地存储和管理以太坊私钥
• 🔌 连接到 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: 创建一个新的以太坊钱包
• import-wallet: 从私钥导入现有钱包
• list-wallets: 列出所有已保存的钱包

区块链操作

• check-balance: 检查地址的 ETH 余额
• get-transactions: 获取地址的最近交易
• send-transaction: 将 ETH 发送到地址

智能合约交互

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

使用示例

以下是一些如何将这些工具与 Claude 一起使用的示例：

创建钱包

您可以问 Claude：

你能用 evm-signer 工具为我创建一个新的以太坊钱包吗？

检查余额

您可以问 Claude：

你能检查一下我在 Sepolia 网络上的以太坊钱包 0x1234...5678 的余额吗？

部署 ERC-20 代币

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

安全注意事项

• 私钥存储在您的本地机器上
• 密钥可以用密码加密
• 服务器仅通过 MCP 协议公开功能
• 在 Claude for Desktop 中批准交易之前，请务必查看交易
• 刚开始时使用 Sepolia 或 Goerli 等测试网络

文档

有关更详细的文档，请参阅：

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

项目结构

mcp-evm-signer/
├── src/                  # 源代码
│   ├── config.ts         # 配置管理
│   ├── crypto.ts         # 密钥管理实用程序
│   ├── ethereum.ts       # 以太坊交互函数
│   └── index.ts          # 主要 MCP 服务器实现
├── keys/                 # 钱包密钥的存储（已忽略）
├── examples/             # 示例用法模式
├── .env.example          # 示例环境变量
└── ...                   # 项目配置文件

开发

要为此项目做出贡献：

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 文件。