Evmcp

io.github.siriuslattice由 GitHub 帳號 siriuslattice 發布v0.1.3更新於 Oct 24, 2026

Multi-chain EVM blockchain data with companion smart contracts

已驗證STDIO僅桌面金融開發者工具

概覽

AI 產生的概覽

唯讀的 MCP 伺服器，透過 Alchemy RPC 讓助理在 Base、Optimism、Avalanche、Celo 與 Arbitrum 上查詢 EVM 鏈上資料，提供 28 個以上工具。

可以做什麼
  • 讀取餘額：原生代幣、ERC20、授權額度以及多鏈餘額查詢
  • 檢視區塊與交易：依雜湊或區塊高度取得區塊、最新區塊、交易、收據以及依 ABI 解碼
  • 查詢合約與代幣：唯讀合約呼叫、位元組碼檢查、儲存槽讀取、ERC20 中介資料與事件日誌
  • 比較 Gas：目前 Gas 價格、Gas 估算、跨鏈 Gas 比較與最便宜鏈建議
  • 在以太坊主網解析 ENS 名稱並反向查詢地址
  • 透過 Multicall3 與配套合約執行批次查詢和跨鏈查詢，並提供鏈資訊與 RPC 健康檢查
適用情境
適合讓助理在五條支援的 EVM 鏈上回答錢包、代幣、合約、交易或 Gas 成本相關問題，而不必自行撰寫 RPC 程式碼。適用於唯讀研究、錢包與合約檢視以及跨鏈比較。
執行需求
以 stdio 在本機執行，通常透過 npx 啟動。需要在 ALCHEMY_API_KEY 中提供 Alchemy API 金鑰，或為各鏈分別提供 RPC URL 覆寫。選用設定包括快取時間、日誌等級、測試網、HTTP 傳輸與 x402 付款閘門。需要能連線至相應的 RPC 端點。
安裝前請注意
Alchemy API 金鑰是可計費的憑證，以明文環境變數傳入，請勿放入共用設定。選用的 x402 設定會啟用付款閘門，並需要一個 USDC 收款地址。工具雖標示為唯讀，但會把地址與查詢傳送給 Alchemy 及公開 RPC 端點，伺服器也會讀取第三方配套合約。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Evmcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

evmcp

EVM + MCP — give your AI assistant blockchain superpowers.

MCP server providing real-time access to on-chain data across Base, Optimism, Avalanche, Celo, and Arbitrum, with companion smart contracts deployed on-chain for batch queries and cross-chain data.

How it Works

EVMCP implements the Model Context Protocol (MCP), a standard that lets AI assistants call external tools. When connected, your AI assistant gains 28 read-only blockchain tools it can invoke to query balances, decode transactions, compare gas prices, and more across five EVM chains.

What sets EVMCP apart is its companion smart contracts — four Solidity contracts deployed on Avalanche and Celo that enable batch queries via Multicall3, an on-chain tool registry, event aggregation, and cross-chain balance caching. The MCP server reads from these contracts; all write operations are performed separately by an admin CLI.

Quick Start

With Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

json
{  "mcpServers": {    "evmcp": {      "command": "npx",      "args": ["-y", "evmcp"],      "env": { "ALCHEMY_API_KEY": "your_key_here" }    }  }}

With Claude Code

bash
claude mcp add evmcp -- npx -y evmcp

Supported Chains

ChainChain IDNative TokenCompanion Contracts
Base8453ETHNot yet deployed
Optimism10ETHNot yet deployed
Avalanche C-Chain43114AVAXDeployed
Celo42220CELODeployed
Arbitrum One42161ETHNot yet deployed

Ethereum mainnet (chain ID 1) is also supported for ENS resolution only.

Tools (29 total)

Balance (3)

ToolDescription
getBalanceGet the native token balance (ETH/AVAX/CELO) of an address on a specific chain
getTokenBalanceGet the ERC20 token balance of an address on a specific chain
getMultiChainBalanceGet the native token balance of an address across all 5 supported chains in parallel

Block (3)

ToolDescription
getBlockGet a block by its hash on a specific chain
getBlockByNumberGet a block by its number on a specific chain, or pass "latest" for the most recent block
getLatestBlockGet the latest block number, timestamp, and base fee for a specific chain

Transaction (3)

ToolDescription
getTransactionGet a transaction by its hash on a specific chain
getTransactionReceiptGet the receipt for a transaction including status, gasUsed, and logs
decodeTransactionDecode a transaction's function call using a provided ABI

Contract (3)

ToolDescription
readContractCall a read-only function on a smart contract with a provided ABI
getContractCodeCheck if an address has contract code deployed, with bytecode length and hash
getStorageAtRead the raw value of a storage slot at a specific address

Token (2)

ToolDescription
getERC20InfoGet ERC20 token metadata including name, symbol, decimals, and total supply
getTokenAllowanceGet the ERC20 token allowance granted by an owner to a spender

Gas (3)

ToolDescription
getGasPriceGet current gas price and EIP-1559 fee data for a specific chain
estimateGasEstimate gas for a transaction on a specific chain
compareGasAcrossChainsCompare current gas prices across all 5 supported chains

ENS (2)

ToolDescription
resolveENSResolve an ENS name (e.g. vitalik.eth) to an Ethereum address via Ethereum L1
lookupAddressReverse lookup an address to its ENS name via Ethereum L1

Events (2)

ToolDescription
getContractEventsGet event logs emitted by a contract on a specific chain
decodeEventLogDecode a raw event log using a provided ABI

Chain and Health (3)

ToolDescription
getChainInfoGet chain name, chain ID, current block number, block time, and native symbol
isContractDeployedCheck if an address has contract code deployed on all 5 supported chains
healthCheckTest connectivity to all 6 RPC endpoints (Ethereum, Base, Optimism, Avalanche, Celo, Arbitrum)

Batch (1)

ToolDescription
batchQueryExecute multiple read calls in a single RPC request using Multicall3

Cross-Chain (2)

ToolDescription
compareBalancesCompare native token balances for an address across all 5 chains
crossChainActivityCheck transaction counts for an address across all 5 chains

Registry (1)

ToolDescription
queryRegistryRead registered tool metadata from the on-chain MCPRegistry companion contract

Optimizer (1)

ToolDescription
gasOptimizerRecommends the cheapest chain for a transaction, accounting for L1 data fees on Base/Optimism/Arbitrum

Resources (4)

URI PatternDescriptionCache TTL
chain://{chainId}/statusCurrent block height and gas price for a chain12s
chain://{chainId}/gasBase fee, gas price, and priority fee in gwei12s
chain://{chainId}/tokens/popularPopular token addresses and decimals (hardcoded for v1)1 hour
evmcp://chainsAll supported chains with IDs, symbols, and companion contract addressesStatic

Supported chain IDs for templated resources: 8453 (Base), 10 (Optimism), 43114 (Avalanche), 42220 (Celo), 42161 (Arbitrum).

Prompts (4)

PromptArgumentsDescription
analyze-walletaddressMulti-chain balance and activity analysis of a wallet
audit-contractcontractAddress, chainBasic inspection and audit workflow for a smart contract
compare-chains(none)Compare gas costs, speed, and characteristics across all chains
investigate-txtxHash, chainDecode, analyze, and trace a transaction in detail

Companion Contracts

Four Solidity contracts are deployed on Avalanche and Celo. The MCP server reads from these contracts to provide batch queries, on-chain tool metadata, and cross-chain data. Base and Optimism deployments are planned.

Avalanche C-Chain (43114)

ContractAddress
MCPRegistry0x62402b65bfb4Fd022285A6FC2F26d8caEEc3D055
BatchQuery0xfDc19e0617AdF1811A68Aa1575409F3769f39491
EventAggregator0xECE24a53A28F088351EC2Da258f78479e81A8007
CrossChainCache0x0899a6Ef23c6B39A4D9B877B219645B89209A670

Celo (42220)

ContractAddress
MCPRegistry0x62402b65bfb4Fd022285A6FC2F26d8caEEc3D055
BatchQuery0xfDc19e0617AdF1811A68Aa1575409F3769f39491
EventAggregator0xECE24a53A28F088351EC2Da258f78479e81A8007
CrossChainCache0x0899a6Ef23c6B39A4D9B877B219645B89209A670

Contract Descriptions

  • MCPRegistry -- On-chain metadata for all EVMCP tools (names, descriptions, versions). Owner-only writes.
  • BatchQuery -- Optimized batch reads via Multicall3. Includes multi-balance, multi-contract-check, and multi-token-balance helpers.
  • EventAggregator -- Caches event count summaries per contract. Updated by the admin CLI.
  • CrossChainCache -- Stores balance snapshots for cross-chain queries. Updated by the admin CLI.

Environment Variables

VariableRequiredDescription
ALCHEMY_API_KEYYes*Alchemy API key (covers all chains)
BASE_RPC_URLNo*Override RPC URL for Base
OPTIMISM_RPC_URLNo*Override RPC URL for Optimism
AVALANCHE_RPC_URLNo*Override RPC URL for Avalanche
CELO_RPC_URLNo*Override RPC URL for Celo
ARBITRUM_RPC_URLNo*Override RPC URL for Arbitrum
ETHEREUM_RPC_URLNoOverride RPC URL for ENS resolution
CACHE_TTL_SECONDSNoCache TTL in seconds (default: 15)
CACHE_MAX_ENTRIESNoMax cache entries (default: 1000)
LOG_LEVELNodebug, info, warn, or error (default: info)
USE_TESTNETSNoUse testnet chains (default: false)

| TRANSPORT | No | stdio (default) or http for Streamable HTTP transport | | HTTP_PORT | No | Port for HTTP transport (default: 3402) | | X402_ENABLED | No | Enable x402 payment gating on HTTP transport | | X402_PAYEE_ADDRESS | No** | USDC receive address on Base | | X402_FACILITATOR_URL | No | x402 facilitator URL (has default) |

*Provide either ALCHEMY_API_KEY or all five individual chain RPC URLs. **Required when X402_ENABLED=true.

Development

bash
pnpm installpnpm buildpnpm inspect          # MCP Inspector UI at localhost:6274pnpm test             # Unit testspnpm typecheck        # Type checkpnpm lint             # ESLint

License

MIT

來源：README.md，提交 c23fe49

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分