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 は Model Context Protocol (MCP) を実装しています。これは AI アシスタントが外部ツールを呼び出せるようにする標準規格です。接続すると、AI アシスタントは残高の照会、トランザクションのデコード、ガス価格の比較などに利用できる 28 個の読み取り専用ブロックチェーンツールを、5 つの EVM チェーンにわたって呼び出せるようになります。

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	未デプロイ

Ethereum メインネット（チェーンID 1）は、ENS 解決のみサポートされています。

ツール（全29種）

残高（3）

ツール	説明
`getBalance`	特定のチェーン上のアドレスのネイティブトークン残高（ETH/AVAX/CELO）を取得します
`getTokenBalance`	特定のチェーン上のアドレスの ERC20 トークン残高を取得します
`getMultiChainBalance`	サポートされている 5 つのチェーンすべてで、アドレスのネイティブトークン残高を並列に取得します

ブロック（3）

ツール	説明
`getBlock`	特定のチェーンでハッシュによりブロックを取得します
`getBlockByNumber`	特定のチェーンで番号によりブロックを取得します。最新ブロックを取得するには "latest" を渡します
`getLatestBlock`	特定のチェーンの最新ブロック番号、タイムスタンプ、ベースフィーを取得します

トランザクション（3）

ツール	説明
`getTransaction`	特定のチェーンでハッシュによりトランザクションを取得します
`getTransactionReceipt`	status、gasUsed、ログを含むトランザクションのレシートを取得します
`decodeTransaction`	提供された ABI を使用してトランザクションの関数呼び出しをデコードします

コントラクト（3）

ツール	説明
`readContract`	提供された ABI を使用してスマートコントラクトの読み取り専用関数を呼び出します
`getContractCode`	アドレスにコントラクトコードがデプロイされているかを確認し、バイトコードの長さとハッシュを取得します
`getStorageAt`	特定のアドレスのストレージスロットの生の値を読み取ります

トークン（2）

ツール	説明
`getERC20Info`	名前、シンボル、小数位数、合計供給量を含む ERC20 トークンのメタデータを取得します
`getTokenAllowance`	所有者がスペンダーに許可した ERC20 トークンの許容量（allowance）を取得します

ガス（3）

ツール	説明
`getGasPrice`	特定のチェーンの現在のガス価格と EIP-1559 の手数料データを取得します
`estimateGas`	特定のチェーン上のトランザクションのガスを見積もります
`compareGasAcrossChains`	サポートされている 5 つのチェーンすべての現在のガス価格を比較します

ENS（2）

ツール	説明
`resolveENS`	ENS 名（例: vitalik.eth）を Ethereum L1 経由で Ethereum アドレスに解決します
`lookupAddress`	アドレスを Ethereum 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`	チェーンの現在のブロック高とガス価格	12s
`chain://{chainId}/gas`	gwei 単位のベースフィー、ガス価格、プライオリティフィー	12s
`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 を介した最適化されたバッチ読み取り。multi-balance、multi-contract-check、multi-token-balance のヘルパーを含みます。
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 または 5 つの個別チェーン RPC URL のいずれかを指定します。 **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 AOAuth
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 9 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 3 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