跳至主要內容
返回範例應用程式

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.

Tech Stack​

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

開始使用​

Install Dependencies​


  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 桌面版 app, go to 克勞德 > 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?
貢獻與回饋
我們非常樂意聽取您的意見，並歡迎您為這個範例應用程式提供任何貢獻！
若要回報問題或提供意見回饋，請在 qn-guide-examples 儲存庫。
若要貢獻，請依照以下步驟操作：
  1. 分叉此儲存庫
  2. 建立功能分支：
    git checkout -b feature/amazing-feature
  3. 將您的變更提交：
    git commit -m "新增超棒的功能"
  4. 推送您的分支：
    git push origin feature/amazing-feature
  5. 開啟一個 Pull Request。
探索更多範例應用程式
Aave V3 清算追蹤器
此應用程式提供對 Aave V3 協議上清算事件的即時監控與深入分析。該應用程式基於無伺服器架構建置，充分展現了 Quicknode Streams 在實現無縫區塊鏈資料串流方面的強大功能。
Aave V3 清算追蹤器
以太坊交易報告應用程式
此應用程式利用 Quicknode 的 EVM Blockbook 擴充功能，針對指定地址擷取並分析以太坊交易，並提供指定日期範圍內的詳細報告。
以太坊交易報告應用程式
以太坊錢包瀏覽器
此應用程式使用 Quicknode 的以太坊端點和 API，向區塊鏈查詢與特定錢包相關的代幣、交易及 NFT。
以太坊錢包瀏覽器