Substrate MCP Server

Субстратный MCP-сервер

Сервер Model Context Protocol (MCP) для блокчейнов Substrate, написанный на Rust. Этот проект предоставляет динамические операции блокчейна Substrate (запрос балансов, блоков, поддонов, хранилищ, событий и т. д.) через протокол MCP и полностью настраивается через переменные среды.

Разработан для взаимодействия с ящиком subxt .

✨ Особенности

• Динамический запрос остатков на счетах и хранилищ
• Список поддонов и их записей
• Извлечение и фильтрация событий и внешних данных
• Отправка и просмотр динамически подписанных транзакций
• Система доступа и блокировка информации
• Пользовательские вызовы RPC к узлам Substrate

🚀 Возможные варианты использования

1. Операции блокчейна на основе искусственного интеллекта
   • Интеграция с LLM (например, Cursor или Claude), чтобы позволить пользователям задавать вопросы на естественном языке (например, «Какой был последний перевод от Алисы?»), которые преобразуются в вызовы инструментов MCP.
   • Создайте чат-бота, который сможет отвечать на вопросы, получать балансы или объяснять активность в цепочке, используя ваш сервер MCP в качестве бэкэнда.
   • Используйте сервер MCP для предоставления оперативных обновлений активности в цепочке, например, изменений баланса или статусов транзакций, для инструментов разработки, таких как VSCode, Cursor, Claude Code и т. д.
2. Пользовательские панели мониторинга и мониторинга
   • Создавайте индивидуальн��е панели мониторинга и системы мониторинга для вашего блокчейна Substrate
   • Отображение данных и аналитики в реальном времени по вашим блокчейн-операциям
   • Настройте оповещения и уведомления о критических событиях
   • Используйте агентов ИИ для обнаружения подозрительной активности путем анализа событий и внешних факторов в режиме реального времени.

🛠️ Требования

• Ржавчина
• Доступ к конечной точке узла Substrate (WebSocket)
• Действительная пара ключей подписи (в шестнадцатеричном формате)
• Файл метаданных времени выполнения для вашей целевой цепочки (наименование и размещение см. ниже)

📦 Установка

Клонируйте репозиторий и соберите:

⚙️ Конфигурация

Создайте файл .env в корне проекта со следующими переменными:

Создание пары ключей подписи

Вы можете сгенерировать пару ключей и получить секретное начальное число в шестнадцатеричном формате, используя подключ :

Используйте поле secretSeed (удалив префикс 0x, если он есть) для SIGNING_KEYPAIR_HEX .

Получение и размещение метаданных времени выполнения

Экспортируйте метаданные времени выполнения из вашего узла и поместите их в artifacts/metadata.scale :

Важно: Файл должен называться metadata.scale и располагаться в каталоге artifacts/ перед сборкой. Сборка завершится ошибкой, если этот файл отсутствует или имеет неправильное имя.

▶️ Использование

Чтобы запустить сервер MCP:

Сервер запустится и будет прослушивать запросы MCP через stdio.

🖇️ Интеграция с курсором

Чтобы использовать этот сервер MCP с Cursor , вам нужно добавить его в конфигурацию Cursor MCP. Это позволяет Cursor обнаруживать и взаимодействовать с вашим сервером Substrate MCP.

1. Соберите свой сервер в режиме релиза:
   cargo build --release
2. Найдите путь к собранному двоичному файлу (обычно target/release/substrate-mcp-rs ).
3. В вашем проекте (или глобальном) файле .cursor/mcp.json добавьте запись для вашего сервера. Например:
   { "mcpServers": { "substrate-mcp-rs": { "command": "$PROJECT_ROOT_ABSOLUTE_PATH/target/release/substrate-mcp-rs", "args": [] } } }
   • Замените путь command на абсолютный путь к собранному вами двоичному файлу, если он отличается.
4. Перезапустите курсор. Теперь он должен обнаружить и подключиться к вашему серверу Substrate MCP, сделав его инструменты доступными для использования.

Более подробную информацию см. в документации по курсору или во введении к протоколу контекста модели .

🧰 Доступные инструменты

Сервер предоставляет набор инструментов для взаимодействия с блокчейном Substrate, включая:

• query_balance : Получить баланс счета
• list_pallets : Список всех поддонов во время выполнения
• list_pallet_entries : Список всех записей хранения для поддона
• dynamic_runtime_call : Выполнение вызова API времени выполнения
• send_dynamic_signed_transaction : создание, подписание и отправка транзакции
• query_storage : Запрос хранилища по поддону и записи
• get_latest_events : Получить все события из последнего блока
• find_events : Поиск определенных событий по поддону и варианту
• get_latest_block : Получить сведения о последнем блоке
• get_block_by_hash : Получить сведения о блоке по хешу
• find_extrinsics : Найти внешние элементы в последнем блоке
• get_system_info : Получить информацию о системе через RPC
• custom_rpc : сделать пользовательский вызов RPC

Полную информацию и параметры см. на сайте src/tooling/substrate.rs

🗂️ Структура проекта

• src/main.rs : точка входа, настраивает ведение журнала и запускает сервер MCP
• src/tooling/ : Содержит реализацию инструмента Substrate
• artifacts/ : Поместите здесь файл метаданных времени выполнения как metadata.scale (обязательно перед сборкой)

📈 Дальнейшие шаги и цели

• [ ] Добавить тесты E2E
• [ ] Добавить модульные тесты
• [ ] Добавить больше инструментов

🤝 Вклад

Вклады приветствуются! Пожалуйста, открывайте проблемы или запросы на извлечение. Для более крупных изменений сначала откройте проблему, чтобы обсудить ваше предложение.

• Следуйте лучшим практикам Rust и обеспечьте документирование кода
• Запустите cargo fmt и cargo clippy перед отправкой
• Добавьте тесты, где это возможно

📄 Лицензия

Массачусетский технологический институт