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 分