Ethereum RPC MPC Server

A TypeScript MCP server that leverages the MCP SDK to support all Ethereum JSON-RPC calls, enabling AI models to interact with blockchain data.

Overview

This project provides a Model Context Protocol (MCP) server that allows AI assistants like Cursor or Claude (or any MCP Client implementation) to interact with Ethereum blockchain data through standardized JSON-RPC interfaces. It acts as a bridge between AI models and EVM blockchains, enabling seamless access to on-chain data and functionality.

Installation

# Clone the repository
git clone [email protected]:Phillip-Kemper/ethereum-rpc-mpc.git
cd ethereum-rpc-mpc

# Install dependencies
yarn install

# Build the project
yarn build

# Start Inspector with default Ethereum RPC (you can change in the inspector settings on )
yarn inspector

Usage

Using with Cursor

To use this MPC server with Cursor:

1. In Cursor, go to Settings > Cursor Settings > MCP
2. Add a new MCP server with the following configuration:
   • Name: Ethereum RPC
   • Type: Command
   • Command: npx -y ethereum-rpc-mpc https://eth.llamarpc.com Ethereum or
   • Command: node /path/to/ethereum-rpc-mpc/dist/server/index.js https://eth.llamarpc.com Ethereum

Analytics

You can also enable analytics using MCP Analytics Middleware to get an overview about number of requests, duration of requests as well as error reporting for all your tools and resources. To enable it, just pass the --analytics flag and additionally a path for the Sqlite File.

• Command: npx -y ethereum-rpc-mpc https://eth.llamarpc.com Ethereum --analytics --db-path /Users/satoshi/Desktop/analytics.db

Starting the Server

You can start the server by providing an Ethereum RPC URL and an optional chain name:

yarn start [RPC_URL] [CHAIN_NAME]

# Using npx (without installing)
npx -y ethereum-rpc-mpc [RPC_URL] [CHAIN_NAME]

If no RPC URL is provided, it will default to “https://eth.llamarpc.com”.

Example:

# Connect to Ethereum mainnet
yarn start https://eth.llamarpc.com Ethereum

# Connect to Zircuit
yarn start https://mainnet.zircuit.com Zircuit

Examples

Here are some examples of how to use the Ethereum RPC MPC server with Claude:

Getting the Current Block Number

What's the current block number?

Checking an Address Balance

What's the ETH balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e?

Getting Contract Information