跳转至主要内容
返回示例应用

EVM MCP 服务器

EVM MCP 服务器将Claude Cursor 等 AI 助手与Ethereum EVM 兼容链上的区块链数据连接起来。借助这款 MCP 服务器工具Claude 能够通过自然对话Claude 钱包余额、分析智能合约并监控 gas 费用，从而使 AIagents能够访问加密货币数据。

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

入门指南​

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 安装

  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 directory.

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-示例 存储库。
如需贡献，请按照以下步骤操作：
  1. 分叉该仓库
  2. 创建一个功能分支：
    git checkout -b feature/amazing-feature
  3. 提交您的更改：
    git commit -m "添加超棒的功能"
  4. 推送您的分支：
    git push origin feature/amazing-feature
  5. 提交一个拉取请求。
探索更多示例应用
Aave V3 清算追踪器
该应用程序可对 Aave V3 协议上的清算事件进行实时监控和深入分析。该应用基于无服务器架构构建，充分展示了Quicknode Streams 无缝区块链数据流Streams 强大功能。
Aave V3 清算追踪器
Ethereum 报告应用程序
This application fetches and analyzes Ethereum transactions for a given address using Quicknode's Blockbook API, providing detailed reports within a specified date range.
Ethereum 报告应用程序
Ethereum 浏览器
该应用程序使用Quicknode Ethereum endpoint API，从区块链中查询与指定钱包相关的代币、交易和 NFT。
Ethereum 浏览器