MCP EVM Signer

MCP server for managing EVM keys and deploying smart contracts via Infura

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "zhangzhongnan928-mcp-evm-signer": {
      "command": "node",
      "args": [
        "/path/to/mcp-evm-signer/build/index.js"
      ],
      "env": {
        "ENCRYPT_KEYS": "true",
        "KEY_PASSWORD": "YOUR_SECURE_PASSWORD",
        "INFURA_API_KEY": "YOUR_INFURA_API_KEY",
        "DEFAULT_NETWORK": "sepolia"
      }
    }
  }
}

You can use the MCP EVM Signer to securely manage Ethereum private keys locally, connect to Infura, and deploy or interact with EVM-compatible smart contracts from Claude for Desktop or other MCP clients. It handles key storage, transaction signing, and contract operations in a streamlined MCP workflow.

How to use

Once you have the MCP EVM Signer running, you can manage wallets, check balances, deploy contracts, and interact with deployed contracts through your MCP client. The server exposes wallet management, blockchain operations, and smart contract interactions in a secure, local workflow that works with Infura-backed networks.

Integrating with Claude for Desktop

Add the MCP EVM Signer to Claude for Desktop so you can issue operations from your chat interface. Use the following configuration snippet to register the server.

{
  "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"
      }
    }
  }
}

How to install

Prerequisites: Node.js v16 or higher, an Infura account with an API key, and Claude for Desktop installed.

Step 1: Clone the project and enter the directory.

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

Step 2: Install dependencies.

npm install

Step 3: Build the project.

npm run build

Step 4: Configure environment variables.

cp .env.example .env

Edit the .env file to add your Infura API key and other settings.

## Security notes and best practices

Private keys are stored locally on your machine and can be encrypted with a password. Review transactions before approving them in Claude for Desktop, and use test networks like Sepolia or Goerli when you are getting started.

## Notes on configuration and workflows

The MCP EVM Signer exposes wallet management, blockchain operations, and contract interactions. Use the provided tools to create or import wallets, check balances, deploy contracts, and call or execute contract methods.

## Available tools

### create-wallet

Create a new Ethereum wallet and store the private key locally

### import-wallet

Import an existing wallet from a private key into the local keystore

### list-wallets

List all saved wallets in the MCP EVM Signer keystore

### check-balance

Check the ETH balance for a specified address on the chosen network

### get-transactions

Retrieve recent transactions for a given address

### send-transaction

Sign and send ETH to a target address from a selected wallet

### deploy-contract

Deploy a smart contract using an ABI and bytecode

### call-contract

Call a read-only contract method and return the result

### execute-contract

Execute a state-changing contract method and wait for the transaction receipt