Ethereum RPC MCP server

This MCP server provides a bridge to interact with the Ethereum blockchain through standardized JSON-RPC methods. It enables AI assistants and applications to query blockchain data using the Model Context Protocol (MCP) framework.

Installation

Prerequisites

Before installing the Ethereum RPC MCP server, ensure you have:

• Node.js installed on your system
• Git for cloning the repository

Setup Instructions

1. Clone the repository:

   git clone https://github.com/yourusername/eth-mpc.git
   

2. Navigate to the project directory:

   cd eth-mpc
   

3. Install dependencies (if needed):

   npm install
   

Adding to MCP Clients

Integration with Cursor

1. Open Cursor application
2. Navigate to Settings → MCP → Add new MCP server
3. Fill in the following details:
   • Name: eth-mcp (or any name you prefer)
   • Type: command
   • Command: node /path/to/eth-mpc/index.js (use the full path to the script)
4. Click "Add" to enable the server

The Ethereum RPC tools will now be available within Cursor.

Other MCP Clients

This server is compatible with any MCP-compliant client, including:

• Claude Desktop
• Claude Code
• Cline
• Other MCP-compatible applications

Available Tools

This MCP server provides three core Ethereum blockchain interaction methods:

• eth_getCode: Retrieves the code stored at a specific Ethereum address
• eth_gasPrice: Returns the current gas price on the Ethereum network
• eth_getBalance: Checks the balance of an Ethereum account

Testing Your Installation

Using MCP Inspector

The MCP Inspector is a helpful development tool for testing your MCP server:

1. Run the inspector:

   npx @modelcontextprotocol/inspector
   

2. Input the command to run your MCP server:

   node /path/to/eth-mpc/index.js
   

3. The Inspector will display available tools and allow you to test them with parameters.

Example: Testing eth_getBalance

1. In the MCP Inspector, select the eth_getBalance tool
2. Enter a valid Ethereum address (e.g., 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 - Vitalik's address)
3. Use latest as the block parameter
4. Submit the request to see the account balance response

Usage Examples

Checking an Ethereum Address Balance

Use the eth_getBalance tool to query an account's balance:

• Address: The Ethereum address to check (e.g., 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045)
• Block Parameter: Usually latest for the current state

Getting Current Gas Price

Use the eth_gasPrice tool to check the current gas price on the Ethereum network. This requires no parameters.

Retrieving Contract Code

Use the eth_getCode tool to fetch the bytecode at a specific address:

• Address: The Ethereum address to check (contract address)
• Block Parameter: Usually latest for the current state

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "eth-mcp" '{"command":"node","args":["/path/to/eth-mpc/index.js"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "eth-mcp": {
            "command": "node",
            "args": [
                "/path/to/eth-mpc/index.js"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "eth-mcp": {
            "command": "node",
            "args": [
                "/path/to/eth-mpc/index.js"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect