evmcp
evmcp
EVM + MCP — дайте вашему ИИ-ассистенту суперспособности блокчейна.
MCP-сервер, предоставляющий доступ в реальном времени к ончейн-данным в сетях Base, Optimism, Avalanche, Celo и Arbitrum, с сопутствующими смарт-контрактами, развернутыми в блокчейне для пакетных запросов и кроссчейн-данных.
Как это работает
EVMCP реализует Model Context Protocol (MCP) — стандарт, который позволяет ИИ-ассистентам вызывать внешние инструменты. После подключения ваш ИИ-ассистент получает 28 инструментов только для чтения, которые он может использовать для запроса балансов, декодирования транзакций, сравнения цен на газ и многого другого в пяти EVM-сетях.
Что отличает EVMCP, так это его сопутствующие смарт-контракты — четыре контракта на Solidity, развернутые в Avalanche и Celo, которые обеспечивают пакетные запросы через 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 (chain ID 1) также поддерживается только для разрешения ENS.
Инструменты (всего 29)
Баланс (3)
Инструмент | Описание |
| Получить баланс нативного токена (ETH/AVAX/CELO) адреса в конкретной сети |
| Получить баланс токена ERC20 адреса в конкретной сети |
| Получить баланс нативного токена адреса во всех 5 поддерживаемых сетях параллельно |
Блок (3)
Инструмент | Описание |
| Получить блок по его хешу в конкретной сети |
| Получить блок по его номеру в конкретной сети, или передайте "latest" для последнего блока |
| Получить номер последнего блока, временную метку и базовую комиссию для конкретной сети |
Транзакция (3)
Инструмент | Описание |
| Получить транзакцию по её хешу в конкретной сети |
| Получить квитанцию о транзакции, включая статус, gasUsed и логи |
| Декодировать вызов функции транзакции с использованием предоставленного ABI |
Контракт (3)
Инструмент | Описание |
| Вызвать функцию только для чтения на смарт-контракте с предоставленным ABI |
| Проверить, развернут ли код контракта по адресу, с длиной и хешем байткода |
| Прочитать сырое значение слота хранилища по конкретному адресу |
Токен (2)
Инструмент | Описание |
| Получить метаданные токена ERC20, включая имя, символ, десятичные знаки и общий запас |
| Получить разрешение на токены ERC20, предоставленное владельцем распорядителю |
Газ (3)
Инструмент | Описание |
| Получить текущую цену газа и данные комиссии EIP-1559 для конкретной сети |
| Оценить газ для транзакции в конкретной сети |
| Сравнить текущие цены на газ во всех 5 поддерживаемых сетях |
ENS (2)
Инструмент | Описание |
| Разрешить имя ENS (например, vitalik.eth) в адрес Ethereum через Ethereum L1 |
| Обратный поиск адреса до его имени ENS через Ethereum L1 |
События (2)
Инструмент | Описание |
| Получить журналы событий, испускаемые контрактом в конкретной сети |
| Декодировать сырой журнал событий с использованием предоставленного ABI |
Сеть и здоровье (3)
Инструмент | Описание |
| Получить название сети, ID сети, текущий номер блока, время блока и символ нативного токена |
| Проверить, развернут ли код контракта по адресу во всех 5 поддерживаемых сетях |
| Проверить подключение ко всем 6 RPC-эндпоинтам (Ethereum, Base, Optimism, Avalanche, Celo, Arbitrum) |
Пакет (1)
Инструмент | Описание |
| Выполнить несколько вызовов чтения в одном RPC-запросе с использованием Multicall3 |
Кроссчейн (2)
Инструмент | Описание |
| Сравнить балансы нативных токенов для адреса во всех 5 сетях |
| Проверить количество транзакций для адреса во всех 5 сетях |
Реестр (1)
Инструмент | Описание |
| Прочитать метаданные зарегистрированных инструментов из ончейн-контракта MCPRegistry |
Оптимизатор (1)
Инструмент | Описание |
| Рекомендует самую дешевую сеть для транзакции с учетом комиссий за данные L1 в Base/Optimism/Arbitrum |
Ресурсы (4)
Шаблон URI | Описание | Время жизни кэша |
| Текущая высота блока и цена газа для сети | 12s |
| Базовая комиссия, цена газа и приоритетная комиссия в gwei | 12s |
| Популярные адреса токенов и десятичные знаки (захардкожено для v1) | 1 час |
| Все поддерживаемые сети с ID, символами и адресами сопутствующих контрактов | Статично |
Поддерживаемые ID сетей для шаблонных ресурсов: 8453 (Base), 10 (Optimism), 43114 (Avalanche), 42220 (Celo), 42161 (Arbitrum).
Промпты (4)
Промпт | Аргументы | Описание |
|
| Мультичейн-анализ баланса и активности кошелька |
|
| Базовый процесс проверки и аудита смарт-контракта |
| (none) | Сравнить стоимость газа, скорость и характеристики во всех сетях |
|
| Декодировать, проанализировать и проследить транзакцию в деталях |
Сопутствующие контракты
Четыре контракта на Solidity развернуты в Avalanche и Celo. MCP-сервер читает данные из этих контрактов для предоставления пакетных запросов, ончейн-метаданных инструментов и кроссчейн-данных. Развертывание в Base и Optimism планируется.
Avalanche C-Chain (43114)
Контракт | Адрес |
MCPRegistry |
|
BatchQuery |
|
EventAggregator |
|
CrossChainCache |
|
Celo (42220)
Контракт | Адрес |
MCPRegistry |
|
BatchQuery |
|
EventAggregator |
|
CrossChainCache |
|
Описания контрактов
MCPRegistry — Ончейн-метаданные для всех инструментов EVMCP (имена, описания, версии). Запись только владельцем.
BatchQuery — Оптимизированные пакетные чтения через Multicall3. Включает помощники для мультибаланса, мультипроверки контрактов и мультибаланса токенов.
EventAggregator — Кэширует сводки количества событий по каждому контракту. Обновляется админ-CLI.
CrossChainCache — Хранит снимки балансов для кроссчейн-запросов. Обновляется админ-CLI.
Переменные окружения
Переменная | Обязательная | Описание |
| Да* | Ключ API Alchemy (покрывает все сети) |
| Нет* | Переопределить RPC URL для Base |
| Нет* | Переопределить RPC URL для Optimism |
| Нет* | Переопределить RPC URL для Avalanche |
| Нет* | Переопределить RPC URL для Celo |
| Нет* | Переопределить RPC URL для Arbitrum |
| Нет | Переопределить RPC URL для разрешения ENS |
| Нет | Время жизни кэша в секундах (по умолчанию: 15) |
| Нет | Максимальное количество записей кэша (по умолчанию: 1000) |
| Нет | debug, info, warn или error (по умолчанию: info) |
| Нет | Использовать тестовые сети (по умолчанию: false) |
| TRANSPORT | Нет | stdio (по умолчанию) или http для Streamable HTTP транспорта |
| HTTP_PORT | Нет | Порт для HTTP транспорта (по умолчанию: 3402) |
| X402_ENABLED | Нет | Включить x402 платежное ограничение на HTTP транспорте |
| X402_PAYEE_ADDRESS | Нет** | Адрес получения USDC на Base |
| X402_FACILITATOR_URL | Нет | URL фасилитатора x402 (есть по умолчанию) |
*Укажите либо ALCHEMY_API_KEY, либо все пять отдельных URL RPC для цепочек.
**Обязательно, когда 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
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.913 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.522 npmMIT