Passer au contenu principal
Retour aux exemples d'applications

Serveur MCP EVM

EVM MCP Server connecte des assistants IA tels que Claude ou Cursor aux données de la blockchain sur Ethereum et d’autres chaînes compatibles EVM. Cet outil de serveur MCP permet à Claude de vérifier les soldes des portefeuilles, d’analyser les contrats et de suivre les prix du gaz par le biais d’une conversation naturelle, rendant ainsi les données cryptographiques accessibles aux agents IA.

Framework/bibliothèque front-end :
Viem
Langue :
TypeScript
Outil de compilation/serveur de développement :
Model Context Protocol
Aperçu de l'application d'exemple

Aperçu

Le protocole MCP (Model Context Protocol) permet aux grands modèles linguistiques (LLM) d’interagir avec des outils externes — tels que des API HTTP, des fichiers ou même des blockchains — à l’aide d’un protocole standardisé basé sur des messages. On peut le considérer comme une interface d’« appel de fonction » à laquelle des agents tels que Claude ou Cursor peuvent se connecter, transformant ainsi un script ou un service en une extension native de l’IA.

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.

Pile technologique

Written tutorial of this project: Create an EVM MCP Server with Claude Desktop

Démarrer

Installer les dépendances


  1. Clone the repository
git clone https://github.com/quiknode-labs/qn-guide-examples.git
cd qn-guide-examples/AI/evm-mcp-server

  1. Installer les dépendances
npm installer

  1. Build the project

Compile the TypeScript code:

npm exécuter la compilation

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 Bureau Claude 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"
}
}
}
}

  • Remplacez your-quicknode-endpoint-name with the name of your Quicknode endpoint.
  • Remplacez your-quicknode-token-id with the token ID of your Quicknode endpoint.
  • Remplacez /absolute-path-to with the absolute path to the evm-mcp-server répertoire.

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


  1. Check a wallet balance:
Give the balance of the 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 address on Ethereum

  1. Analyze a contract:
Analyze 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 on Ethereum

  1. Get current gas prices:
Analyze the current gas prices on Ethereum, is it a good time to use the chain?
Contributions et commentaires
Nous serions ravis de connaître votre avis et nous vous invitons à contribuer à cette application d'exemple !
Pour signaler des problèmes ou faire part de vos commentaires, ouvrez un ticket GitHub dans le qn-guide-exemples référentiel.
Pour contribuer, procédez comme suit :
  1. Créer une branche du dépôt
  2. Créer une branche de fonctionnalité :
    git checkout -b feature/amazing-feature
  3. Validez vos modifications :
    git commit -m "Ajout d'une fonctionnalité géniale"
  4. Publiez votre branche :
    git push origin feature/amazing-feature
  5. Créez une Pull Request.