Ethereum RPC

🚀 Ethereum RPC MCP Server

An MCP (Model Context Protocol) server for interacting with the Ethereum blockchain. It offers tools to query Ethereum blockchain data via standard JSON - RPC methods, enabling AI assistants and applications to interact with the Ethereum blockchain through a standardized protocol.

🚀 Quick Start

This MCP server provides tools to query Ethereum blockchain data via standard JSON - RPC methods, facilitating the interaction between AI assistants/applications and the Ethereum blockchain.

✨ Features

This MCP server offers three key Ethereum RPC methods as tools:

• eth_getCode: Retrieve the code of a specific Ethereum address.
• eth_gasPrice: Obtain the current gas price of the Ethereum network.
• eth_getBalance: Check the balance of an Ethereum account.

Note: More features are under development.

💻 Usage Examples

Adding to Cursor

To add this MCP to Cursor:

1. First, clone this repository:

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

2. Open Cursor settings → MCP → Add a new MCP server.

3. Enter a name (e.g., “eth - mcp”).

4. Select “Command” as the type.

5. Enter the full script path:

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

6. Click “Add” to enable the server.

Once added, the Ethereum RPC tools will be available in Cursor.

This server uses stdio transport, making it compatible with Cursor, Claude Desktop, and other MCP - compatible clients.

Testing with Inspector

The MCP Inspector is a development tool for testing and debugging MCP servers. It provides an interactive interface to test your MCP server's functionality without a full - fledged AI client.

Running the Inspector

To test your Ethereum RPC MCP server using the Inspector:

1. Run the Inspector:

   npx @modelcontextprotocol/inspector
   

2. Enter the command and path.

3. The Inspector will connect to your running MCP server and display the available tools.

Testing Tools with Inspector

The Inspector allows you to:

• View available tools and their descriptions.
• Test each tool with different parameters.
• View responses in a structured format.
• Debug any issues in the MCP server implementation.

For example, to test the eth_getBalance tool:

1. Select the tool in the Inspector interface.
2. Enter a valid Ethereum address (e.g., 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 - Vitalik's address).
3. Use the default block parameter (latest).
4. Submit the request and view the response.

📚 Documentation

Integrating into MCP Clients

This MCP server can be integrated into any MCP - compatible client, including:

• Claude Desktop
• Claude Code
• Cursor (see instructions above)
• Cline
• Other MCP - compatible applications

When integrated, client applications can directly use the tools provided by the server to query Ethereum blockchain data.

Understanding MCP

The Model Context Protocol (MCP) is an open standard that allows AI models to interact with various tools and services. It provides developers with a standardized way to expose APIs, data sources, and functionality to AI assistants.

More about MCP

MCP servers, like this project, form an ecosystem that enables AI assistants to perform complex tasks across multiple services without custom integration for each service.

📚 Official Documentation: Model Context Protocol Overview

📄 License

MIT

🔧 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.