evmcp
evmcp
EVM + MCP — verleihen Sie Ihrem KI-Assistenten Blockchain-Superkräfte.
MCP-Server, der Echtzeitzugriff auf On-Chain-Daten über Base, Optimism, Avalanche, Celo und Arbitrum bietet, mit begleitenden Smart Contracts, die für Batch-Abfragen und Cross-Chain-Daten on-chain bereitgestellt werden.
So funktioniert es
EVMCP implementiert das Model Context Protocol (MCP), einen Standard, der es KI-Assistenten ermöglicht, externe Tools aufzurufen. Nach der Verbindung erhält Ihr KI-Assistent 28 schreibgeschützte Blockchain-Tools, die er aufrufen kann, um Salden abzufragen, Transaktionen zu dekodieren, Gaspreise zu vergleichen und mehr über fünf EVM-Ketten.
Was EVMCP auszeichnet, sind seine begleitenden Smart Contracts – vier Solidity-Verträge, die auf Avalanche und Celo bereitgestellt werden und Batch-Abfragen über Multicall3, ein On-Chain-Tool-Registry, Ereignisaggregation und Cross-Chain-Saldo-Caching ermöglichen. Der MCP-Server liest aus diesen Verträgen; alle Schreiboperationen werden separat von einer Admin-CLI durchgeführt.
Related MCP server: chain-data
Schnellstart
Mit Claude Desktop
Fügen Sie zu Ihrer Claude-Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"evmcp": {
"command": "npx",
"args": ["-y", "evmcp"],
"env": { "ALCHEMY_API_KEY": "your_key_here" }
}
}
}Mit Claude Code
claude mcp add evmcp -- npx -y evmcpUnterstützte Chains
Chain | Chain ID | Natives Token | Begleitende Verträge |
Base | 8453 | ETH | Noch nicht bereitgestellt |
Optimism | 10 | ETH | Noch nicht bereitgestellt |
Avalanche C-Chain | 43114 | AVAX | Bereitgestellt |
Celo | 42220 | CELO | Bereitgestellt |
Arbitrum One | 42161 | ETH | Noch nicht bereitgestellt |
Ethereum-Mainnet (Ketten-ID 1) wird ebenfalls nur für die ENS-Auflösung unterstützt.
Tools (29 insgesamt)
Balance (3)
Tool | Beschreibung |
| Ermittelt das native Token-Guthaben (ETH/AVAX/CELO) einer Adresse auf einer bestimmten Kette. |
| Ermittelt das ERC20-Token-Guthaben einer Adresse auf einer bestimmten Kette. |
| Ermittelt das native Token-Guthaben einer Adresse parallel über alle 5 unterstützten Ketten. |
Block (3)
Tool | Beschreibung |
| Ermittelt einen Block anhand seines Hashs auf einer bestimmten Kette. |
| Ermittelt einen Block anhand seiner Nummer auf einer bestimmten Kette, oder übergeben Sie „latest“ für den neuesten Block. |
| Ermittelt die neueste Blocknummer, den Zeitstempel und die Basisgebühr für eine bestimmte Kette. |
Transaction (3)
Tool | Beschreibung |
| Ermittelt eine Transaktion anhand ihres Hashs auf einer bestimmten Kette. |
| Ermittelt die Quittung für eine Transaktion, einschließlich Status, gasUsed und Logs. |
| Dekodiert den Funktionsaufruf einer Transaktion mithilfe einer bereitgestellten ABI. |
Contract (3)
Tool | Beschreibung |
| Ruft eine schreibgeschützte Funktion eines Smart Contracts mit einer bereitgestellten ABI auf. |
| Prüft, ob eine Adresse Vertragscode bereitgestellt hat, einschließlich Bytecode-Länge und Hash. |
| Liest den Rohwert eines Speicherplatzes an einer bestimmten Adresse. |
Token (2)
Tool | Beschreibung |
| Ermittelt ERC20-Token-Metadaten, einschließlich Name, Symbol, Dezimalstellen und Gesamtangebot. |
| Ermittelt die ERC20-Token-Freigabe, die ein Eigentümer einem Ausgeber gewährt hat. |
Gas (3)
Tool | Beschreibung |
| Ermittelt den aktuellen Gaspreis und EIP-1559-Gebührendaten für eine bestimmte Kette. |
| Schätzt das Gas für eine Transaktion auf einer bestimmten Kette. |
| Vergleicht aktuelle Gaspreise über alle 5 unterstützten Ketten. |
ENS (2)
Tool | Beschreibung |
| Löst einen ENS-Namen (z. B. vitalik.eth) über Ethereum L1 in eine Ethereum-Adresse auf. |
| Führt eine umgekehrte Suche einer Adresse zu ihrem ENS-Namen über Ethereum L1 durch. |
Events (2)
Tool | Beschreibung |
| Ermittelt Ereignisprotokolle, die von einem Vertrag auf einer bestimmten Kette ausgegeben wurden. |
| Dekodiert ein rohes Ereignisprotokoll mithilfe einer bereitgestellten ABI. |
Chain and Health (3)
Tool | Beschreibung |
| Ermittelt Kettenname, Ketten-ID, aktuelle Blocknummer, Blockzeit und natives Symbol. |
| Prüft, ob eine Adresse auf allen 5 unterstützten Ketten Vertragscode bereitgestellt hat. |
| Testet die Konnektivität zu allen 6 RPC-Endpunkten (Ethereum, Base, Optimism, Avalanche, Celo, Arbitrum). |
Batch (1)
Tool | Beschreibung |
| Führt mehrere Leseaufrufe in einer einzigen RPC-Anfrage mithilfe von Multicall3 aus. |
Cross-Chain (2)
Tool | Beschreibung |
| Vergleicht native Token-Guthaben für eine Adresse über alle 5 Ketten. |
| Prüft Transaktionsanzahlen für eine Adresse über alle 5 Ketten. |
Registry (1)
Tool | Beschreibung |
| Liest registrierte Tool-Metadaten aus dem On-Chain-MCPRegistry-Begleitvertrag. |
Optimizer (1)
Tool | Beschreibung |
| Empfiehlt die günstigste Kette für eine Transaktion, unter Berücksichtigung von L1-Datengebühren auf Base/Optimism/Arbitrum. |
Ressourcen (4)
URI-Muster | Beschreibung | Cache-TTL |
| Aktuelle Blockhöhe und Gaspreis für eine Kette | 12s |
| Basisgebühr, Gaspreis und Prioritätsgebühr in gwei | 12s |
| Beliebte Token-Adressen und Dezimalstellen (für v1 fest codiert) | 1 Stunde |
| Alle unterstützten Ketten mit IDs, Symbolen und Adressen der Begleitverträge | Statisch |
Unterstützte Ketten-IDs für vorlagenbasierte Ressourcen: 8453 (Base), 10 (Optimism), 43114 (Avalanche), 42220 (Celo), 42161 (Arbitrum).
Prompts (4)
Prompt | Argumente | Beschreibung |
|
| Multi-Chain-Saldo- und Aktivitätsanalyse einer Wallet |
|
| Grundlegender Inspektions- und Audit-Workflow für einen Smart Contract |
| (keine) | Vergleicht Gaskosten, Geschwindigkeit und Eigenschaften über alle Ketten |
|
| Dekodiert, analysiert und verfolgt eine Transaktion im Detail |
Begleitende Verträge
Vier Solidity-Verträge sind auf Avalanche und Celo bereitgestellt. Der MCP-Server liest aus diesen Verträgen, um Batch-Abfragen, On-Chain-Tool-Metadaten und Cross-Chain-Daten bereitzustellen. Bereitstellungen auf Base und Optimism sind geplant.
Avalanche C-Chain (43114)
Vertrag | Adresse |
MCPRegistry |
|
BatchQuery |
|
EventAggregator |
|
CrossChainCache |
|
Celo (42220)
Vertrag | Adresse |
MCPRegistry |
|
BatchQuery |
|
EventAggregator |
|
CrossChainCache |
|
Vertragsbeschreibungen
MCPRegistry – On-Chain-Metadaten für alle EVMCP-Tools (Namen, Beschreibungen, Versionen). Nur Eigentümer können schreiben.
BatchQuery – Optimierte Batch-Lesevorgänge über Multicall3. Enthält Hilfsfunktionen für Multi-Saldo, Multi-Vertragsprüfung und Multi-Token-Saldo.
EventAggregator – Zwischenspeichert Ereigniszählungs-Zusammenfassungen pro Vertrag. Wird von der Admin-CLI aktualisiert.
CrossChainCache – Speichert Saldo-Snapshots für Cross-Chain-Abfragen. Wird von der Admin-CLI aktualisiert.
Umgebungsvariablen
Variable | Erforderlich | Beschreibung |
| Ja* | Alchemy-API-Schlüssel (deckt alle Ketten ab) |
| Nein* | Überschreibt die RPC-URL für Base |
| Nein* | Überschreibt die RPC-URL für Optimism |
| Nein* | Überschreibt die RPC-URL für Avalanche |
| Nein* | Überschreibt die RPC-URL für Celo |
| Nein* | Überschreibt die RPC-URL für Arbitrum |
| Nein | Überschreibt die RPC-URL für die ENS-Auflösung |
| Nein | Cache-TTL in Sekunden (Standard: 15) |
| Nein | Maximale Cache-Einträge (Standard: 1000) |
| Nein | debug, info, warn oder error (Standard: info) |
| Nein | Testnetz-Ketten verwenden (Standard: false) |
| TRANSPORT | Nein | stdio (Standard) oder http für Streamable-HTTP-Transport |
| HTTP_PORT | Nein | Port für HTTP-Transport (Standard: 3402) |
| X402_ENABLED | Nein | Aktiviert x402-Zahlungs-Gating auf HTTP-Transport |
| X402_PAYEE_ADDRESS | Nein** | USDC-Empfangsadresse auf Base |
| X402_FACILITATOR_URL | Nein | x402-Facilitator-URL (hat Standardwert) |
*Geben Sie entweder ALCHEMY_API_KEY oder alle fünf einzelnen Chain-RPC-URLs an.
**Erforderlich, wenn X402_ENABLED=true.
Entwicklung
pnpm install
pnpm build
pnpm inspect # MCP Inspector UI at localhost:6274
pnpm test # Unit tests
pnpm typecheck # Type check
pnpm lint # ESLintLizenz
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only on-chain intelligence for AI agents on Base: balances, tokens, gas, tx status.
Read-only on-chain intelligence for AI agents on Base: balances, tokens, gas, tx status.
Provide AI agents and automation tools with contextual access to blockchain data including balance…
Pay-per-call on-chain data for AI agents: token, wallet, risk, whale, NFT, tx. No API keys.
Related MCP Servers
AlicenseBqualityDmaintenanceEnables AI assistants to access and explain blockchain data across 100+ networks using natural language, without requiring authentication.95 npmMIT- 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
- AlicenseAqualityCmaintenanceRead-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.5MIT
- AlicenseNot gradedqualityBmaintenanceEnables querying on-chain data (balances, transactions, token transfers, blocks) across 20+ EVM chains through natural language.706 npmMIT