elysium-chain-mcp
MCP-сервер читает блоки, балансы и контракты сети Elysium; подпись транзакций включается флагом и принимает только тестовую сеть.
- 148 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Включенная запись подписывает и отправляет транзакции ключом из `ELYSIUM_PRIVATE_KEY`, а `dry_run: false` агент может передать сам.
- Ключ остается в конфигурации клиента, а тексты обозревателя и имена в цепочке могут направлять агента.
- Лимиты и список адресов действуют на верхний уровень транзакции: `transfer` или `approve` разрешенного токена уходит на любой адрес.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/elysium-chain-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Включенная запись подписывает и отправляет транзакции ключом из `ELYSIUM_PRIVATE_KEY`, а `dry_run: false` агент может передать сам.
- Ключ остается в конфигурации клиента, а тексты обозревателя и имена в цепочке могут направлять агента.
- Лимиты и список адресов действуют на верхний уровень транзакции: `transfer` или `approve` разрешенного токена уходит на любой адрес.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
elysium-chain-mcp — MCP-сервер для Elysium, L2 на Arbitrum Orbit от Kinetiq для Hyperliquid. Восемь инструментов чтения доступны всегда: статус сети, блоки, транзакции с квитанцией, балансы HYPE и ERC-20, данные токена, вызов `view`-функций, журналы событий и симуляция вызова без подписи. Еще семь инструментов обозревателя блоков появляются при заданном `EXPLORER_API_URL`. Два инструмента записи, `send_native` и `write_contract`, регистрируются только при `ENABLE_WRITES=true` и принимают исключительно chain ID `99801` тестовой сети. По умолчанию они работают в режиме `dry_run: true`: симулируют транзакцию и возвращают ее без подписи.
Для кого. Разработчикам и исследователям контрактов Elysium, которые дают агенту читать цепочку и пробуют транзакции в тестовой сети.
Подходит, если
- Агент разбирает транзакцию по хешу: квитанция, комиссия, расшифрованный вызов и журналы.
- Проверяют баланс HYPE и до 20 токенов ERC-20 по адресу.
- Перед отправкой симулируют вызов контракта через `simulate_call` и смотрят оценку газа.
- Отлаживают свой контракт в тестовой сети: вызов функции идет с лимитами на сумму и комиссию.
Не подходит, если
- Ключ с реальными средствами хотят положить в `ELYSIUM_PRIVATE_KEY`: запись принимает только `99801`, но ключ остается в конфигурации клиента.
- Нужны операции в основной сети Elysium: запись там отключена.
- Токен-контракты рассчитывают ограничить списком адресов: разрешенный контракт все равно можно вызвать с `transfer` или `approve` на любой адрес.
- Тексты из обозревателя считают доверенными: их пишут третьи лица, и они пытаются управлять агентом.
Пример запроса к агенту
Покажи состояние сети Elysium и баланс HYPE по адресу, затем симулируй отправку 0,001 HYPE без подписи.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
ELYSIUM_RPC_URLобязательная- Адрес JSON-RPC узла Elysium.
ELYSIUM_CHAIN_IDобязательная- Chain ID, который должен обслуживать узел; для тестовой сети 99801.
EXPLORER_API_URL- Адрес API обозревателя; включает семь инструментов обозревателя.
ENABLE_WRITES- Регистрирует `send_native` и `write_contract`; по умолчанию false.
ELYSIUM_PRIVATE_KEYсекрет- 32-байтовый ключ тестового аккаунта, нужен при включенной записи.
MAX_SEND_HYPE- Максимум HYPE в одной транзакции, по умолчанию 0,01.
MAX_FEE_HYPE- Максимум HYPE на комиссию одной транзакции, по умолчанию 0,001.
WRITE_ALLOWLIST- Адреса назначения через запятую; по умолчанию разрешен любой.
MCP_HTTP_TOKENсекрет- Bearer-токен от 16 символов для HTTP-режима вне loopback и при записи.
Ограничения
Версия 0.1.1, неофициальный проект сообщества: к Kinetiq и Hyperliquid отношения не имеет. Нужен Node.js 20 или новее. API обозревателя недокументирован, индексированные балансы могут отставать, источник истины — RPC. Статус `pending` или `SEND_STATUS_UNKNOWN` значит, что транзакция могла уже попасть в узел: найдите ее по хешу через `get_transaction` до повторной отправки. Запись по HTTP требует `MCP_HTTP_TOKEN`.
Как отключить. Уберите запись `elysium` из `mcpServers` и остановите свой HTTP-процесс. Если задавали `ELYSIUM_PRIVATE_KEY`, удалите ключ из конфигурации клиента: он хранится там и после запуска.
Частые вопросы
Может ли сервер отправлять транзакции в основной сети?
Нет. Инструменты записи регистрируются только при `ENABLE_WRITES=true` и принимают лишь chain ID `99801`, то есть тестовую сеть.
Какие проверки проходит запись перед подписью?
Адрес назначения по `WRITE_ALLOWLIST`, если список задан, и лимит `MAX_SEND_HYPE` (по умолчанию 0,01), chain ID узла, успешный `eth_call`, лимит комиссии `MAX_FEE_HYPE` (по умолчанию 0,001) и достаточный баланс.
Может ли агент обойти dry_run?
Может: по умолчанию `dry_run` равен true, но агент способен передать false сам. Оставьте подтверждение вызовов `send_native` и `write_contract` в клиенте.
Как подключить сервер к Cursor?
Добавьте в `mcp.json` объект `mcpServers` с командой `npx -y elysium-chain-mcp` и переменными `ELYSIUM_RPC_URL` и `ELYSIUM_CHAIN_ID` из README.
Какие инструменты чтения есть?
`get_chain_status`, `get_block`, `get_transaction`, `get_balance`, `get_token_info`, `read_contract`, `get_logs` и `simulate_call`. Входы и выходы описаны в `docs/TOOLS.md`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыEVM MCP Server — блокчейн для агента
EVM MCP Server
MCP-сервер для сетей EVM: агент читает блоки, балансы и контракты, подтягивает ABI из Etherscan и по ключу подписывает транзакции
Официальный MCP-сервер и скиллы CCXT: рыночные данные, балансы и торговля по выбору на криптобиржах и рынках предсказаний
Официальный MCP-сервер биржи Bybit: рыночные данные, счета, ордера, боты и потоки WebSocket из Claude, Cursor и VS Code
Удаленный MCP-сервер Vybe для данных Solana: просмотр схем API и живые запросы к ончейн и рыночной аналитике
Счета, акты и УПД в Эльбе из чата с агентом, публичные ссылки на документы для клиентов и сводка неоплаченных счетов
MCP-сервер тестового биткоин-кошелька BSL
bsl-agent-mcp
MCP-сервер, который дает агенту управлять тестовым биткоин-кошельком в сети Bitcoin-IPC testnet: пополнение, платежи, проверка баланса
Коротко о README
Репозиторий содержит исходники на TypeScript, документацию по запуску, инструментам, обозревателю и записи, а также модульные и интеграционные тесты. Ограничения записи вынесены в отдельный раздел с перечнем проверок.