EVM MCP Server — блокчейн для агента
EVM MCP Server
MCP-сервер для сетей EVM: агент читает блоки, балансы и контракты, подтягивает ABI из Etherscan и по ключу подписывает транзакции
- 379 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Приватный ключ или мнемоника открывают кошелек: агент может переводить средства, одобрять расходование и подписывать сообщения
- Записывающие вызовы контрактов необратимы и тратят газ
- HTTP-режим слушает все сетевые интерфейсы без авторизации
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/evm-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Приватный ключ или мнемоника открывают кошелек: агент может переводить средства, одобрять расходование и подписывать сообщения
- Записывающие вызовы контрактов необратимы и тратят газ
- HTTP-режим слушает все сетевые интерфейсы без авторизации
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
EVM MCP Server дает агенту единый интерфейс к более чем 60 сетям, совместимым с EVM: основные сети, включая Ethereum, Optimism, Arbitrum, Base, Polygon, Avalanche и BSC, и тестовые. Сервер написан на TypeScript с библиотекой Viem и отдает 25 инструментов, а также ресурсы с адресами вида `evm://{сеть}/...` и подсказки с готовыми сценариями. Инструменты читают блоки, транзакции и чеки с декодированными логами, балансы нативной монеты и токенов ERC20, ERC721 и ERC1155, цену газа и данные о сетях. Во всех параметрах-адресах можно писать имена ENS вроде vitalik.eth. Для смарт-контрактов сервер сам подтягивает ABI из Etherscan v2 для всех поддерживаемых сетей, читает состояние, вызывает функции и объединяет несколько чтений в один запрос через Multicall3. Если задан кошелек, агент может переводить нативные токены и ERC20, одобрять расходование, вызывать записывающие функции контрактов и подписывать сообщения и данные EIP-712. Подсказки ведут агента по подготовке перевода, разбору кошелька, исследованию контракта, аудиту разрешений и диагностике ошибок транзакций.
Для кого. Для разработчиков смарт-контрактов и аналитиков ончейн-данных, которые хотят читать цепочки и работать с контрактами из Cursor или Claude Desktop.
Подходит, если
- Нужно узнать баланс адреса или ENS-имени в нескольких сетях и по нужным токенам
- Требуется разобрать транзакцию по хэшу: статус, чек и декодированные логи
- Нужно прочитать состояние контракта без знания его ABI: сервер подтянет описание из Etherscan
- Перед подписанием надо проверить разрешения токенов кошелька подсказкой аудита
- Для теста на сети Sepolia или Base Sepolia нужно перевести небольшую сумму с отдельного тестового кошелька
Не подходит, если
- Нужны сети вне EVM, например Solana или Bitcoin: сервер поддерживает только EVM
- Нужно хранить крупные суммы на кошельке сервера: ключ или мнемоника лежат в переменной окружения и доступны процессу сервера
- Нужен сервер для боевого запуска в открытой сети: HTTP-режим слушает все интерфейсы и не включает авторизацию
- Нужна торговля на биржах с ордерами и стаканом: инструменты работают с блокчейном напрямую, биржевых API в них нет
Пример запроса к агенту
Покажи баланс vitalik.eth в основной сети Ethereum и в Base, затем получи транзакцию по этому хэшу и расшифруй ее логи.MCP
- Транспорт
- stdio, sse
- Авторизация
- ключ необязателен
Переменные окружения
EVM_PRIVATE_KEYсекрет- Приватный ключ кошелька для записывающих инструментов. Задавайте только для тестового кошелька.
EVM_MNEMONICсекрет- Мнемоническая фраза BIP-39 из 12 или 24 слов как альтернатива ключу.
EVM_ACCOUNT_INDEX- Номер счета при выводе из мнемоники, по умолчанию 0.
ETHERSCAN_API_KEYсекрет- Ключ Etherscan для автоматического получения ABI во всех сетях.
Ограничения
Нужен Node.js 20 или новее либо Bun 1.0. Для записи в сеть задайте кошелек: переменную EVM_PRIVATE_KEY с приватным ключом либо EVM_MNEMONIC с мнемонической фразой BIP-39 и необязательный EVM_ACCOUNT_INDEX. Без кошелька работает только чтение. Автоподбор ABI требует бесплатного ключа ETHERSCAN_API_KEY, один ключ действует на все сети через Etherscan v2.
У режима HTTP жестко заданы порт 3001 и адрес 0.0.0.0, то есть сервер слушает все сетевые интерфейсы, и менять значения нужно в файле `src/server/http-server.ts`. Сеть по умолчанию — основная сеть Ethereum с идентификатором цепи 1. Автор советует ключ не хранить в Git, использовать HTTPS и ограничение частоты в продакшене, а для дорогих операций добавлять шаг подтверждения.
Доступность Etherscan и узлов сетей из России при подготовке карточки не проверялась.
Как отключить. Удалите блок evm-mcp-server из конфигурации клиента, например `.cursor/mcp.json`, и перезапустите клиент. Затем уберите из окружения переменные EVM_PRIVATE_KEY или EVM_MNEMONIC и отзовите разрешения токенов, выданные инструментом approve_token_spending.
Частые вопросы
Как подключить EVM MCP Server к Cursor?
Добавьте в `.cursor/mcp.json` сервер с командой `npx` и аргументами `-y`, `@mcpdotdirect/evm-mcp-server`. Либо введите в настройках Cursor тип command и команду `npx @mcpdotdirect/evm-mcp-server`. HTTP-вариант запускается добавлением `--http`.
Нужен ли приватный ключ, чтобы читать блокчейн?
Нет. Чтение блоков, транзакций, балансов и состояния контрактов работает без кошелька. Ключ или мнемоника нужны инструментам записи: переводам, одобрениям, вызову записывающих функций и подписи сообщений.
Какие сети поддерживает EVM MCP Server?
Более 60. Среди основных Ethereum, Optimism, Arbitrum, Base, Polygon, Avalanche, BSC, zkSync Era и Linea, среди тестовых Sepolia, Holesky и Base Sepolia. Список возвращает инструмент get_supported_networks.
Как сервер узнает ABI контракта?
Инструмент get_contract_abi запрашивает его в Etherscan v2, а read_contract и write_contract подтягивают ABI сами, если вы не передали параметр abiJson. Для этого нужен бесплатный ключ ETHERSCAN_API_KEY.
Чем EVM MCP Server отличается от CCXT MCP Server?
EVM MCP Server работает с блокчейнами напрямую: узлы сетей, контракты, ENS и подпись транзакций. CCXT обращается к API бирж, поэтому подходит для рыночных данных и ордеров на биржах.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер читает блоки, балансы и контракты сети Elysium; подпись транзакций включается флагом и принимает только тестовую сеть.
Сервер дает агенту чтение ваших банковских счетов и операций через Enable Banking без инструментов отправки платежей.
Удаленный MCP-сервер Vybe для данных Solana: просмотр схем API и живые запросы к ончейн и рыночной аналитике
Официальный MCP-сервер и скиллы CCXT: рыночные данные, балансы и торговля по выбору на криптобиржах и рынках предсказаний
Официальный MCP-сервер биржи Bybit: рыночные данные, счета, ордера, боты и потоки WebSocket из Claude, Cursor и VS Code
MCP-сервер для агентного трейдинга: бэктест, 462 готовые альфы, разбор торгового журнала и мультиагентные аналитические команды
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| EVM MCP Server — блокчейн для агента (эта карточка) | нет | ключ необязателен | 379 | |
| CCXT MCP Server | да | ключ необязателен | 44 869 | рыночные данные, балансы и ордера на биржах через API CCXT |
| Alpaca MCP Server | да | API-ключ | 1 078 | ордера на акции, ETF и криптовалюту через брокера Alpaca |
Коротко о README
README начинается с обзора и списка функций, затем перечисляет все сети. После идут требования, установка, настройка переменных для кошелька и ключа Etherscan, режимы stdio и HTTP, подключение к Cursor. Справочник описывает инструменты по группам, ресурсы и подсказки, раздел безопасности и структуру проекта.