MCP EVM Signer

MCP EVM Signer

A Model Context Protocol (MCP) server for managing Ethereum private keys and deploying smart contracts using Infura. This server enables Claude for Desktop and other MCP clients to interact with EVM-compatible blockchains.

Features

• 🔑 Securely store and manage Ethereum private keys locally
• 🔌 Connect to Infura for blockchain interactions
• 📝 Deploy smart contracts from compiled ABIs and bytecode
• ✍️ Sign and send transactions
• 💰 View account balances and transaction history
• 🔍 Query blockchain data and interact with deployed contracts

Quick Start

Prerequisites

• Node.js v16 or higher
• An Infura account with API key
• Claude for Desktop app installed

Installation

1. Clone this repository:
   git clone https://github.com/zhangzhongnan928/mcp-evm-signer.git cd mcp-evm-signer
2. Install dependencies:
   npm install
3. Build the project:
   npm run build
4. Configure environment variables:
   cp .env.example .env
   Edit the .env file to add your Infura API key and configure other settings.

Integrating with Claude for Desktop

1. Add the server to your Claude for Desktop configuration:

2. Restart Claude for Desktop
3. You can now ask Claude to deploy smart contracts, check balances, or interact with EVM blockchains

Available Tools

The MCP EVM Signer server exposes the following tools for use with Claude:

Wallet Management

• create-wallet: Create a new Ethereum wallet
• import-wallet: Import an existing wallet from a private key
• list-wallets: List all saved wallets

Blockchain Operations

• check-balance: Check the ETH balance of an address
• get-transactions: Get recent transactions for an address
• send-transaction: Send ETH to an address

Smart Contract Interactions

• deploy-contract: Deploy a smart contract from ABI and bytecode
• call-contract: Call a read-only contract method
• execute-contract: Execute a contract method that modifies state

Example Usage

Below are some examples of how you can use these tools with Claude:

Creating a Wallet

You can ask Claude:

Checking a Balance

You can ask Claude:

Deploying an ERC-20 Token

See our ERC-20 token example for a complete walkthrough of deploying and interacting with an ERC-20 token contract.

Security Notes

• Private keys are stored locally on your machine
• Keys can be encrypted with a password
• The server only exposes functionality through the MCP protocol
• Always review transactions before approving them in Claude for Desktop
• Use test networks like Sepolia or Goerli when getting started

Documentation

For more detailed documentation, please refer to:

• Usage Guide: Detailed usage instructions and examples
• Examples: Sample workflows and contract deployments

Project Structure

Development

To contribute to this project:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Commit your changes (git commit -m 'Add some amazing feature')
5. Push to the branch (git push origin feature/amazing-feature)
6. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.