de en es ja ko ru zh

evmcp

Name: evmcp
Author: siriuslattice

by siriuslattice

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

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: chain-data

빠른 시작

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)

도구	설명
`getBalance`	특정 체인에서 주소의 네이티브 토큰 잔액(ETH/AVAX/CELO) 조회
`getTokenBalance`	특정 체인에서 주소의 ERC20 토큰 잔액 조회
`getMultiChainBalance`	5개 지원 체인 전체에서 주소의 네이티브 토큰 잔액을 병렬로 조회

블록 (3)

도구	설명
`getBlock`	특정 체인에서 해시로 블록 조회
`getBlockByNumber`	특정 체인에서 번호로 블록 조회, 또는 최신 블록을 위해 "latest" 전달
`getLatestBlock`	특정 체인의 최신 블록 번호, 타임스탬프, 기본 수수료 조회

트랜잭션 (3)

도구	설명
`getTransaction`	특정 체인에서 해시로 트랜잭션 조회
`getTransactionReceipt`	상태, gasUsed, 로그를 포함한 트랜잭션 영수증 조회
`decodeTransaction`	제공된 ABI를 사용하여 트랜잭션의 함수 호출 디코딩

계약 (3)

도구	설명
`readContract`	제공된 ABI로 스마트 계약의 읽기 전용 함수 호출
`getContractCode`	주소에 계약 코드가 배포되어 있는지 확인, 바이트코드 길이 및 해시 포함
`getStorageAt`	특정 주소의 스토리지 슬롯 원시 값 읽기

토큰 (2)

도구	설명
`getERC20Info`	이름, 심볼, 소수점 자릿수, 총 공급량을 포함한 ERC20 토큰 메타데이터 조회
`getTokenAllowance`	소유자가 스펜더에게 부여한 ERC20 토큰 승인额度 조회

가스 (3)

도구	설명
`getGasPrice`	특정 체인의 현재 가스 가격 및 EIP-1559 수수료 데이터 조회
`estimateGas`	특정 체인의 트랜잭션 가스 추정
`compareGasAcrossChains`	5개 지원 체인 전체의 현재 가스 가격 비교

ENS (2)

도구	설명
`resolveENS`	이더리움 L1을 통해 ENS 이름(예: vitalik.eth)을 이더리움 주소로 확인
`lookupAddress`	이더리움 L1을 통해 주소를 ENS 이름으로 역조회

이벤트 (2)

도구	설명
`getContractEvents`	특정 체인에서 계약이 발생시킨 이벤트 로그 조회
`decodeEventLog`	제공된 ABI를 사용하여 원시 이벤트 로그 디코딩

체인 및 상태 (3)

도구	설명
`getChainInfo`	체인 이름, 체인 ID, 현재 블록 번호, 블록 시간, 네이티브 심볼 조회
`isContractDeployed`	5개 지원 체인 전체에서 주소에 계약 코드가 배포되어 있는지 확인
`healthCheck`	6개 RPC 엔드포인트(Ethereum, Base, Optimism, Avalanche, Celo, Arbitrum) 연결성 테스트

배치 (1)

도구	설명
`batchQuery`	Multicall3를 사용하여 단일 RPC 요청으로 여러 읽기 호출 실행

크로스체인 (2)

도구	설명
`compareBalances`	5개 체인 전체에서 주소의 네이티브 토큰 잔액 비교
`crossChainActivity`	5개 체인 전체에서 주소의 트랜잭션 수 확인

레지스트리 (1)

도구	설명
`queryRegistry`	온체인 MCPRegistry 컴패니언 계약에서 등록된 도구 메타데이터 읽기

최적화 (1)

도구	설명
`gasOptimizer`	Base/Optimism/Arbitrum의 L1 데이터 수수료를 고려하여 트랜잭션에 가장 저렴한 체인 추천

리소스 (4)

URI 패턴	설명	캐시 TTL
`chain://{chainId}/status`	체인의 현재 블록 높이 및 가스 가격	12초
`chain://{chainId}/gas`	gwei 단위의 기본 수수료, 가스 가격, 우선 수수료	12초
`chain://{chainId}/tokens/popular`	인기 토큰 주소 및 소수점 자릿수(v1에서는 하드코딩)	1시간
`evmcp://chains`	ID, 심볼, 컴패니언 계약 주소를 포함한 모든 지원 체인	정적

템플릿 리소스에 지원되는 체인 ID: 8453(Base), 10(Optimism), 43114(Avalanche), 42220(Celo), 42161(Arbitrum).

프롬프트 (4)

프롬프트	인수	설명
`analyze-wallet`	`address`	지갑의 멀티체인 잔액 및 활동 분석
`audit-contract`	`contractAddress`, `chain`	스마트 계약의 기본 검사 및 감사 워크플로
`compare-chains`	(없음)	모든 체인의 가스 비용, 속도, 특성 비교
`investigate-tx`	`txHash`, `chain`	트랜잭션을 상세히 디코딩, 분석, 추적

컴패니언 계약

4개의 Solidity 계약이 Avalanche와 Celo에 배포되어 있습니다. MCP 서버는 이 계약들에서 데이터를 읽어 배치 쿼리, 온체인 도구 메타데이터, 크로스체인 데이터를 제공합니다. Base 및 Optimism 배포는 계획 중입니다.

Avalanche C-Chain (43114)

계약	주소
MCPRegistry	`0x62402b65bfb4Fd022285A6FC2F26d8caEEc3D055`
BatchQuery	`0xfDc19e0617AdF1811A68Aa1575409F3769f39491`
EventAggregator	`0xECE24a53A28F088351EC2Da258f78479e81A8007`
CrossChainCache	`0x0899a6Ef23c6B39A4D9B877B219645B89209A670`

Celo (42220)

계약	주소
MCPRegistry	`0x62402b65bfb4Fd022285A6FC2F26d8caEEc3D055`
BatchQuery	`0xfDc19e0617AdF1811A68Aa1575409F3769f39491`
EventAggregator	`0xECE24a53A28F088351EC2Da258f78479e81A8007`
CrossChainCache	`0x0899a6Ef23c6B39A4D9B877B219645B89209A670`

계약 설명

MCPRegistry -- 모든 EVMCP 도구의 온체인 메타데이터(이름, 설명, 버전). 소유자 전용 쓰기.
BatchQuery -- Multicall3를 통한 최적화된 배치 읽기. 다중 잔액, 다중 계약 확인, 다중 토큰 잔액 헬퍼 포함.
EventAggregator -- 계약별 이벤트 수 요약을 캐싱. 관리자 CLI가 업데이트.
CrossChainCache -- 크로스체인 쿼리를 위한 잔액 스냅샷 저장. 관리자 CLI가 업데이트.

환경 변수

변수	필수	설명
`ALCHEMY_API_KEY`	예*	Alchemy API 키(모든 체인 커버)
`BASE_RPC_URL`	아니요*	Base용 RPC URL 재정의
`OPTIMISM_RPC_URL`	아니요*	Optimism용 RPC URL 재정의
`AVALANCHE_RPC_URL`	아니요*	Avalanche용 RPC URL 재정의
`CELO_RPC_URL`	아니요*	Celo용 RPC URL 재정의
`ARBITRUM_RPC_URL`	아니요*	Arbitrum용 RPC URL 재정의
`ETHEREUM_RPC_URL`	아니요	ENS 확인용 RPC URL 재정의
`CACHE_TTL_SECONDS`	아니요	캐시 TTL(초, 기본값: 15)
`CACHE_MAX_ENTRIES`	아니요	최대 캐시 항목 수(기본값: 1000)
`LOG_LEVEL`	아니요	debug, info, warn, error(기본값: info)
`USE_TESTNETS`	아니요	테스트넷 체인 사용(기본값: false)

*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 deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Related MCP Connectors

Base Intel MCP A
io.github.selflabbs
Read-only on-chain intelligence for AI agents on Base: balances, tokens, gas, tx status.
Blockchain Cryptocurrency Web3 & Decentralized Tech
2
https://base.selflabbs.com/mcp
Base Intel MCP A
com.datakoot
Read-only on-chain intelligence for AI agents on Base: balances, tokens, gas, tx status.
Blockchain Web3 & Decentralized Tech
51
https://base.datakoot.com/mcp
blockscout-mcp-server A
ai.smithery
Provide AI agents and automation tools with contextual access to blockchain data including balance…
Blockchain Web3 & Decentralized Tech Search
16246
https://server.smithery.ai/@blockscout/mcp-server/mcp
cortexcloud B
io.github.jonahthan433
Pay-per-call on-chain data for AI agents: token, wallet, risk, whale, NFT, tx. No API keys.
AI & Machine Learning Blockchain Payments & Billing
191
https://api.cortexcloud.org/mcp

Related MCP Servers

Noves MCP Serverofficial
Blockchain Web3 & Decentralized Tech
Noves-Inc
A
license
B
quality
D
maintenance
Enables AI assistants to access and explain blockchain data across 100+ networks using natural language, without requiring authentication.
Updated a year ago (2025-06-17 17:45 UTC)
9
5 npm
MIT
chain-data
Cryptocurrency Blockchain
Baneado98
A
license
A
quality
C
maintenance
Enables 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.
Updated 4 months ago (2026-06-22 16:39 UTC)
4
MIT
Base Intel MCP
Blockchain Cryptocurrency
datakoot
A
license
A
quality
C
maintenance
Read-only on-chain intelligence for AI agents on Base, providing tools to read balances, token metadata, gas, and transaction status live from chain without API keys.
Updated 12 days ago (2026-10-24 06:27 UTC)
5
MIT
mcp-blockscout
Blockchain Cryptocurrency
pipeworx-io
A
license
Not graded
quality
B
maintenance
Enables querying on-chain data (balances, transactions, token transfers, blocks) across 20+ EVM chains through natural language.
Updated 5 days ago (2026-10-30 20:06 UTC)
706 npm
MIT

evmcp

작동 방식

빠른 시작

Claude Desktop 사용 시

Claude Code 사용 시

지원 체인

도구 (총 29개)

잔액 (3)

블록 (3)

트랜잭션 (3)

계약 (3)

토큰 (2)

가스 (3)

ENS (2)

이벤트 (2)

체인 및 상태 (3)

배치 (1)

크로스체인 (2)

레지스트리 (1)

최적화 (1)

리소스 (4)

프롬프트 (4)

컴패니언 계약

Avalanche C-Chain (43114)

Celo (42220)

계약 설명

환경 변수

개발

라이선스

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Noves MCP Serverofficial

chain-data

Base Intel MCP

mcp-blockscout