evmcp
evmcp
EVM + MCP — AI 어시스턴트에 블록체인 슈퍼파워를 부여하세요.
Base, Optimism, Avalanche, Celo, Arbitrum 전반의 온체인 데이터에 대한 실시간 액세스를 제공하는 MCP 서버로, 배치 쿼리 및 크로스체인 데이터를 위한 컴패니언 스마트 계약이 온체인에 배포되어 있습니다.
작동 방식
EVMCP는 AI 어시스턴트가 외부 도구를 호출할 수 있게 해주는 표준인 Model Context Protocol(MCP)을 구현합니다. 연결되면 AI 어시스턴트는 5개의 EVM 체인에서 잔액 조회, 트랜잭션 디코딩, 가스 가격 비교 등을 수행할 수 있는 28개의 읽기 전용 블록체인 도구를 호출할 수 있습니다.
EVMCP를 차별화하는 핵심은 컴패니언 스마트 계약입니다. Avalanche와 Celo에 배포된 4개의 Solidity 계약으로, Multicall3를 통한 배치 쿼리, 온체인 도구 레지스트리, 이벤트 집계, 크로스체인 잔액 캐싱을 가능하게 합니다. MCP 서버는 이 계약들에서 데이터를 읽습니다. 모든 쓰기 작업은 관리자 CLI가 별도로 수행합니다.
Related MCP server: Bink MCP Server
빠른 시작
Claude Desktop 사용 시
Claude Desktop 설정(~/Library/Application Support/Claude/claude_desktop_config.json)에 추가하세요:
{
"mcpServers": {
"evmcp": {
"command": "npx",
"args": ["-y", "evmcp"],
"env": { "ALCHEMY_API_KEY": "your_key_here" }
}
}
}Claude Code 사용 시
claude mcp add evmcp -- npx -y evmcp지원 체인
체인 | 체인 ID | 네이티브 토큰 | 컴패니언 계약 |
Base | 8453 | ETH | 아직 배포 안 됨 |
Optimism | 10 | ETH | 아직 배포 안 됨 |
Avalanche C-Chain | 43114 | AVAX | 배포됨 |
Celo | 42220 | CELO | 배포됨 |
Arbitrum One | 42161 | ETH | 아직 배포 안 됨 |
이더리움 메인넷(체인 ID 1)은 ENS 확인 전용으로도 지원됩니다.
도구 (총 29개)
잔액 (3)
도구 | 설명 |
| 특정 체인에서 주소의 네이티브 토큰 잔액(ETH/AVAX/CELO) 조회 |
| 특정 체인에서 주소의 ERC20 토큰 잔액 조회 |
| 5개 지원 체인 전체에서 주소의 네이티브 토큰 잔액을 병렬로 조회 |
블록 (3)
도구 | 설명 |
| 특정 체인에서 해시로 블록 조회 |
| 특정 체인에서 번호로 블록 조회, 또는 최신 블록을 위해 "latest" 전달 |
| 특정 체인의 최신 블록 번호, 타임스탬프, 기본 수수료 조회 |
트랜잭션 (3)
도구 | 설명 |
| 특정 체인에서 해시로 트랜잭션 조회 |
| 상태, gasUsed, 로그를 포함한 트랜잭션 영수증 조회 |
| 제공된 ABI를 사용하여 트랜잭션의 함수 호출 디코딩 |
계약 (3)
도구 | 설명 |
| 제공된 ABI로 스마트 계약의 읽기 전용 함수 호출 |
| 주소에 계약 코드가 배포되어 있는지 확인, 바이트코드 길이 및 해시 포함 |
| 특정 주소의 스토리지 슬롯 원시 값 읽기 |
토큰 (2)
도구 | 설명 |
| 이름, 심볼, 소수점 자릿수, 총 공급량을 포함한 ERC20 토큰 메타데이터 조회 |
| 소유자가 스펜더에게 부여한 ERC20 토큰 승인额度 조회 |
가스 (3)
도구 | 설명 |
| 특정 체인의 현재 가스 가격 및 EIP-1559 수수료 데이터 조회 |
| 특정 체인의 트랜잭션 가스 추정 |
| 5개 지원 체인 전체의 현재 가스 가격 비교 |
ENS (2)
도구 | 설명 |
| 이더리움 L1을 통해 ENS 이름(예: vitalik.eth)을 이더리움 주소로 확인 |
| 이더리움 L1을 통해 주소를 ENS 이름으로 역조회 |
이벤트 (2)
도구 | 설명 |
| 특정 체인에서 계약이 발생시킨 이벤트 로그 조회 |
| 제공된 ABI를 사용하여 원시 이벤트 로그 디코딩 |
체인 및 상태 (3)
도구 | 설명 |
| 체인 이름, 체인 ID, 현재 블록 번호, 블록 시간, 네이티브 심볼 조회 |
| 5개 지원 체인 전체에서 주소에 계약 코드가 배포되어 있는지 확인 |
| 6개 RPC 엔드포인트(Ethereum, Base, Optimism, Avalanche, Celo, Arbitrum) 연결성 테스트 |
배치 (1)
도구 | 설명 |
| Multicall3를 사용하여 단일 RPC 요청으로 여러 읽기 호출 실행 |
크로스체인 (2)
도구 | 설명 |
| 5개 체인 전체에서 주소의 네이티브 토큰 잔액 비교 |
| 5개 체인 전체에서 주소의 트랜잭션 수 확인 |
레지스트리 (1)
도구 | 설명 |
| 온체인 MCPRegistry 컴패니언 계약에서 등록된 도구 메타데이터 읽기 |
최적화 (1)
도구 | 설명 |
| Base/Optimism/Arbitrum의 L1 데이터 수수료를 고려하여 트랜잭션에 가장 저렴한 체인 추천 |
리소스 (4)
URI 패턴 | 설명 | 캐시 TTL |
| 체인의 현재 블록 높이 및 가스 가격 | 12초 |
| gwei 단위의 기본 수수료, 가스 가격, 우선 수수료 | 12초 |
| 인기 토큰 주소 및 소수점 자릿수(v1에서는 하드코딩) | 1시간 |
| ID, 심볼, 컴패니언 계약 주소를 포함한 모든 지원 체인 | 정적 |
템플릿 리소스에 지원되는 체인 ID: 8453(Base), 10(Optimism), 43114(Avalanche), 42220(Celo), 42161(Arbitrum).
프롬프트 (4)
프롬프트 | 인수 | 설명 |
|
| 지갑의 멀티체인 잔액 및 활동 분석 |
|
| 스마트 계약의 기본 검사 및 감사 워크플로 |
| (없음) | 모든 체인의 가스 비용, 속도, 특성 비교 |
|
| 트랜잭션을 상세히 디코딩, 분석, 추적 |
컴패니언 계약
4개의 Solidity 계약이 Avalanche와 Celo에 배포되어 있습니다. MCP 서버는 이 계약들에서 데이터를 읽어 배치 쿼리, 온체인 도구 메타데이터, 크로스체인 데이터를 제공합니다. Base 및 Optimism 배포는 계획 중입니다.
Avalanche C-Chain (43114)
계약 | 주소 |
MCPRegistry |
|
BatchQuery |
|
EventAggregator |
|
CrossChainCache |
|
Celo (42220)
계약 | 주소 |
MCPRegistry |
|
BatchQuery |
|
EventAggregator |
|
CrossChainCache |
|
계약 설명
MCPRegistry -- 모든 EVMCP 도구의 온체인 메타데이터(이름, 설명, 버전). 소유자 전용 쓰기.
BatchQuery -- Multicall3를 통한 최적화된 배치 읽기. 다중 잔액, 다중 계약 확인, 다중 토큰 잔액 헬퍼 포함.
EventAggregator -- 계약별 이벤트 수 요약을 캐싱. 관리자 CLI가 업데이트.
CrossChainCache -- 크로스체인 쿼리를 위한 잔액 스냅샷 저장. 관리자 CLI가 업데이트.
환경 변수
변수 | 필수 | 설명 |
| 예* | Alchemy API 키(모든 체인 커버) |
| 아니요* | Base용 RPC URL 재정의 |
| 아니요* | Optimism용 RPC URL 재정의 |
| 아니요* | Avalanche용 RPC URL 재정의 |
| 아니요* | Celo용 RPC URL 재정의 |
| 아니요* | Arbitrum용 RPC URL 재정의 |
| 아니요 | ENS 확인용 RPC URL 재정의 |
| 아니요 | 캐시 TTL(초, 기본값: 15) |
| 아니요 | 최대 캐시 항목 수(기본값: 1000) |
| 아니요 | debug, info, warn, error(기본값: info) |
| 아니요 | 테스트넷 체인 사용(기본값: false) |
| TRANSPORT | 아니요 | stdio(기본값) 또는 Streamable HTTP 전송을 위한 http |
| HTTP_PORT | 아니요 | HTTP 전송용 포트 (기본값: 3402) |
| X402_ENABLED | 아니요 | HTTP 전송에서 x402 결제 게이팅 활성화 |
| X402_PAYEE_ADDRESS | 아니요** | Base에서 USDC 수신 주소 |
| X402_FACILITATOR_URL | 아니요 | x402 facilitator URL (기본값 있음) |
*ALCHEMY_API_KEY 또는 개별 체인 RPC URL 5개를 모두 제공하세요.
**X402_ENABLED=true인 경우 필수입니다.
개발
pnpm install
pnpm build
pnpm inspect # MCP Inspector UI at localhost:6274
pnpm test # Unit tests
pnpm typecheck # Type check
pnpm lint # ESLint라이선스
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides tools for querying onchain data across 12+ blockchain networks, including token balances, transaction analysis, and smart contract security auditing. It enables users to interact with multiple EVM-compatible chains and perform deep contract evaluations through natural language interfaces.1

Bink MCP Serverofficial
FlicenseNot gradedqualityDmaintenanceEnables AI agents to perform blockchain operations like wallet management, token info, DeFi swaps, cross-chain bridging, and price checking across Ethereum, BNB Chain, and Solana.
Noves MCP Serverofficial
AlicenseBqualityDmaintenanceEnables AI assistants to access and explain blockchain data across 100+ networks using natural language, without requiring authentication.923MIT- AlicenseAqualityCmaintenanceEnables AI agents to fetch live multi-chain portfolio, token info, gas prices, and token prices across Ethereum, Base, Polygon, Arbitrum, and Optimism with a single call. No API key required.4MIT
Related MCP Connectors
Read-only on-chain intelligence for AI agents on Base: balances, tokens, gas, tx status.
Read-only on-chain intel for AI agents on Base: balances, tokens, gas, tx status. No API keys.
Provide AI agents and automation tools with contextual access to blockchain data including balance…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/siriuslattice/evmcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server