メインコンテンツへスキップ
サンプルに戻るアプリ

EVM MCP サーバー

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.

GitHubアイコン
リポジトリを見る
フロントエンドフレームワーク／ライブラリ：
Viem
言語：
TypeScript
ビルドツール／開発サーバー：
Model Context Protocol
サンプルアプリのプレビュー

概要

The Model Context Protocol (MCP) enables Large Language Models (LLMs) to interact with external tools — like HTTP APIs, files, or even blockchains — using a standardized message-based protocol. Think of it as a "function-calling" interface that agents like Claude or Cursor can plug into, turning a script or service into an AI-native extension.

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.

技術スタック​

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

はじめに​

依存関係をインストールする​


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

  1. Install dependencies
npm install

  1. Build the project

Compile the TypeScript code:

npm run build

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 > 開発者. 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"
            }
        }
    }
}

  • 置換 your-quicknode-endpoint-name with the name of your Quicknode endpoint.
  • 置換 your-quicknode-token-id with the token ID of your Quicknode endpoint.
  • 置換 /absolute-path-to with the absolute path to the evm-mcp-server ディレクトリ。

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?
投稿とフィードバック
皆様からのご意見をお待ちしております。また、このサンプルアプリへのご協力も大歓迎です！
問題を報告したりフィードバックを共有したりするには、GitHubでIssueを作成してください。 qn-guide-examples リポジトリ。
コントリビュートするには、以下の手順に従ってください：
  1. リポジトリをフォークしてください
  2. フィーチャーブランチを作成してください：
    git checkout -b feature/amazing-feature
  3. 変更をコミットします：
    git commit -m "Add amazing feature"
  4. ブランチをプッシュしてください：
    git push origin feature/amazing-feature
  5. プルリクエストを作成してください。
その他のサンプルを見るアプリ
Aave V3清算トラッカー
This application provides real-time monitoring and in-depth analysis of liquidation events on the Aave V3 protocol. Built on a serverless architecture, this app showcases the power of Quicknode Streams for seamless blockchain data streaming.
Aave V3清算トラッカー
Ethereumトランザクションレポートアプリケーション
このアプリケーションは、QuicknodeのBlockbook APIを使用して、指定したアドレスのEthereumトランザクションを取得・分析し、指定した期間の詳細なレポートを提供します。
Ethereumトランザクションレポートアプリケーション
Ethereumウォレットエクスプローラー
This application uses Quicknode's Ethereum endpoint and APIs to query the blockchain for tokens, transactions, and NFTs associated with a given wallet.
Ethereumウォレットエクスプローラー