EVM MCP-Server
EVM MCP Server connects AI assistants like Claude or Cursor to blockchain data across Ethereum and other EVM-compatible chains. This MCP server tool lets Claude check wallet balances, analyze contracts, and monitor gas prices through natural conversation, making crypto data accessible to AI agents.

Übersicht
Das Model Context Protocol (MCP) ermöglicht es großen Sprachmodellen (LLMs), mithilfe eines standardisierten, nachrichtenbasierten Protokolls mit externen Tools – wie HTTP-APIs, Dateien oder sogar Blockchains – zu interagieren. Man kann es sich als eine Schnittstelle zum „Aufrufen von Funktionen“ vorstellen, an die sich Agenten wie Claude oder Cursor anbinden können, um ein Skript oder einen Dienst in eine KI-native Erweiterung zu verwandeln.
In this guide, you'll learn how to build and deploy a MCP server that enables LLM agents to access blockchain data across multiple EVM-compatible networks. This powerful integration allows AI models like Claude to interact directly with blockchain data, opening up new possibilities for Web3 automation and analysis.
Tech Stack
Written tutorial of this project: Create an EVM MCP Server with Claude Desktop
Erste Schritte
Abhängigkeiten installieren
- Clone the repository
git clone https://github.com/quiknode-labs/qn-guide-examples.git
cd qn-guide-examples/AI/evm-mcp-server
- Install dependencies
npm installieren
- Build the project
Compile the TypeScript code:
npm npm build ausführen
Configure Claude Desktop
Environment variables are used to configure the server. These variables will be defined in Claude Desktop's configuration file, claude_desktop_config.json.
To configure, open the Claude Desktop app, go to Claude > Settings > Developer. Then, modify the claude_desktop_config.json file with the following content: (if you already have other configurations, add the new configuration under the mcpServers object)
{
"mcpServers": {
"evm": {
"command": "node",
"args": [
"/absolute-path-to/evm-mcp-server/build/index.js"
],
"env": {
"QN_ENDPOINT_NAME": "your-quicknode-endpoint-name",
"QN_TOKEN_ID": "your-quicknode-token-id"
}
}
}
}
- Ersetzen
your-quicknode-endpoint-namewith the name of your Quicknode endpoint. - Ersetzen
your-quicknode-token-idwith the token ID of your Quicknode endpoint. - Ersetzen
/absolute-path-towith the absolute path to theevm-mcp-serverVerzeichnis.
Test the MCP Server
Restart Claude Desktop and test the server by asking Claude Desktop to perform a task that requires the EVM MCP Server. For example, ask Claude Desktop to get balance of an address on any supported chain.
Example Agent Interactions
- Check a wallet balance:
Give the balance of the 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 address on Ethereum
- Analyze a contract:
Analyze 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 on Ethereum
- Get current gas prices:
Analyze the current gas prices on Ethereum, is it a good time to use the chain?
- Das Repository forken
- Erstelle einen Feature-Branch:git checkout -b feature/amazing-feature
- Speichere deine Änderungen:git commit -m "Tolle Funktion hinzufügen"
- Deinen Branch pushen:git push origin feature/amazing-feature
- Erstelle einen Pull Request.