Rome CLI + MCP

CLI для разработчиков Rome и MCP-сервер — проверенные факты о цепочке, правильный шаблон сборки и уникальные для Rome действия (пополнение, развёртывание, проверка) для человека или ИИ-агента.

rome проводит разработчика — человека или ИИ-агента — через весь жизненный цикл разработки на Rome: проверенные факты о цепочке, правильный шаблон, вызовы контрактов, входной шлюз для пополнения, deploy/send, диагностика между ВМ и проверка работоспособности для обеих дорожек. Один общий набор возможностей, два согласованных интерфейса — CLI (rome <command>) и MCP сервер (rome mcp) — так агент и человек используют одну и ту же ментальную модель.

Установка

Сначала репозиторий (публикация в npm ожидается):

# разовый запуск, без установки:
npx github:rome-protocol/rome-cli facts chain hadrian

# постоянная установка — клонировать и связать:
git clone https://github.com/rome-protocol/rome-cli
cd rome-cli && npm install && npm install -g .

Обычная npm install -g github:rome-protocol/rome-cli не работает сегодня — npm подготавливает git-зависимости пакета без собственных node_modules (rome-cli#25). Используйте разовый запуск через npx или clone + link. Закрепляйте тег (github:rome-protocol/rome-cli#v0.8.0), когда вам нужны воспроизводимые запуски.

Два слоя над одним ядром

Чтение — привязка к фактам и диагностика. Без ключей; и в CLI, и на MCP-сервере.

Команда	Что она возвращает
rome facts chain·tokens·contracts·gas·balance·programs	актуальные факты о цепочке из реестра + RPC — без выдуманных идентификаторов, адресов и селекторов
rome cookbook patterns·cpi-recipe·errors	какой пример соответствует вашей цели · правила аккаунтов CPI, в которых агенты ошибаются · расшифровать сбой Rome → причина + исправление
rome call <chain> <addr> <sig> [args]	прочитать контракт (eth_call) — аргументы с несколькими значениями передаются в одном аргументе через запятую: "0xOwner…,0xSpender…"
rome doctor <chain>	предварительная проверка — сеть доступна? RPC достижим? программа настроена? кошелек пополнен?
rome tx <chain> <hash>	диагностировать транзакцию — квитанция EVM + транзакция(и) урегулирования Solana + ссылка Via (у Rome нет debug_trace*)
rome preset foundry|hardhat <chain>	готовая конфигурация сети Rome для вашего стека инструментов + особенности

Действия — подпись в цепочке. Только в CLI, ключ из окружения, никогда на MCP.

Команда	Что делает
rome deploy <chain> <artifact>	развернуть скомпилированный контракт, учитывая особенности газа Rome
rome send <chain> <addr> <sig>	записать в контракт через правильный путь записи Rome
rome fund <chain> --from <src> --amount <usdc>	перевести USDC → газ Rome (CCTP) — входной шлюз «из дома»
rome bridge <chain> --from <src> --amount <usdc> [--intent gas|wrapper]	мостить USDC в как газ или wUSDC
rome bridge <chain> --to <dest> --amount <usdc>	мостить wUSDC из — сжечь на Rome; вы получаете на целевой сети (Rome спонсирует входящий перевод, а не получение исходящего)
rome activate <chain>	одноразовое пополнение PDA требуется перед первым исходящим мостом (входящий перевод без трения — ничего не требует)
rome verify <chain> [--path …]	этот проверка работоспособности с учетом пути, по одному для каждого пути входа: solidity — один и тот же контракт отвечает на дорожке EVM и на дорожке Solana · solana-program — вызов на дорожке EVM запускает вашу программу Solana через CPI · из дома — мост внутрь → действие в Rome → мост наружу, круговой маршрут подтвержден

Подключите к ИИ-агенту (MCP)

Вам не нужно ничего запускать или размещать — ваш MCP-клиент запускает rome mcp (сервер stdio) по запросу. Зарегистрируйте его один раз:

{ "mcpServers": { "rome": { "command": "npx", "args": ["-y", "github:rome-protocol/rome-cli", "mcp"] } } }

(При установке через clone + link, { "command": "rome", "args": ["mcp"] } тоже работает — форме npx просто не требуется предварительная установка.)

Затем агент вызывает такие инструменты, как facts_chain, cookbook_cpi_recipe, doctor, txи preset — опираясь на актуальный реестр + RPC, поэтому он перестает угадывать адреса и селекторы. Интерфейс MCP только для чтения и не содержит ключей — его безопасно подключать к любому агенту; он никогда не сможет подписывать или перемещать средства. Действия с подписью остаются в CLI, а ключ передается через окружение.

Цикл привязки агента к фактам

1. rome cookbook patterns <что я создаю> → какой пример репозитория + архитектура

2. rome facts chain <chain> → RPC, ID программы, токен газа (без хардкода)

3. …пишите код, опираясь именно на эти значения…

4. rome verify <chain> --path <ваш путь входа> → подтвердить, что все работает, каким бы путем вы ни пришли

Подробнее

• Репозиторий + полные руководства: rome-protocol/rome-cli

• Экосистема и репозитории · Создайте приложение с двумя дорожками · Из дома: доберитесь до Rome из другой цепочки