EVM MCP 서버

EVM MCP 서버는 Claude 같은 AI 어시스턴트를 Ethereum 기타 EVM 호환 체인의 블록체인 데이터와 연결해 줍니다. 이 MCP 서버 도구를 통해 Claude 자연스러운 대화를 통해 지갑 잔액을 Claude , 스마트 계약을 분석하며, 가스 요금을 모니터링할 수 있어, AI agents 암호화폐 데이터에 쉽게 접근할 수 있게 해줍니다.

Author

Sergen Uysal

리포지토리 보기

프론트엔드 프레임워크/라이브러리:

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

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 설치

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

Replace your-quicknode-endpoint-name with the name of your Quicknode endpoint.
Replace your-quicknode-token-id with the token ID of your Quicknode endpoint.
Replace /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

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?

기여 및 피드백

여러분의 의견을 듣고 싶으며, 이 샘플 앱에 대한 모든 기여를 환영합니다!

문제를 신고하거나 피드백을 공유하려면, 다음에서 GitHub 이슈를 생성해 주세요. qn-가이드-예시 저장소.

기여하시려면 다음 단계를 따르세요:

저장소를 포크하기
기능 브랜치 생성:
git checkout -b feature/amazing-feature
변경 사항을 커밋하세요:
git commit -m "멋진 기능 추가"
브랜치를 푸시하세요:
git push origin feature/amazing-feature
풀 리퀘스트를 제출하세요.

더 많은 샘플 앱 살펴보기

Aave V3 청산 추적기

이 애플리케이션은 Aave V3 프로토콜에서 발생하는 청산 이벤트를 실시간으로 모니터링하고 심층적으로 분석해 줍니다. 서버리스 아키텍처 기반으로 구축된 이 앱은 원활한 블록체인 데이터 스트리밍을Streams 강력한 성능을 보여줍니다.

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 탐색기

이 애플리케이션은 Quicknode Ethereum endpoint API를 사용하여, 특정 지갑과 관련된 토큰, 거래 내역 및 NFT에 대한 정보를 블록체인에서 조회합니다.

EVM MCP 서버

개요

기술 스택​

시작하기​

Install Dependencies​

Configure Claude Desktop​