Сервер Helius MCP

Сервер Helius MCP предоставляет инструментам ИИ прямой доступ к API Helius через 10 общедоступных инструментов: 9 маршрутизируемых инструментов, сгруппированных по предметным областям и охватывающих все функции Helius и Solana, а также expandResult для постраничного просмотра больших ответов.

9 Routed Tools

Инструменты, сгруппированные по предметным областям (heliusWallet, heliusAsset, heliusTransaction, …): каждое действие Helius доступно через один из них

Account Signup

Создайте учетную запись Helius из своего инструмента ИИ: оплатите через размещенную платежную ссылку или настройте автоматическую оплату в USDC с помощью локальной пары ключей

Real-Time Data

Подключайтесь к Enhanced WebSockets и LaserStream gRPC непосредственно из своего инструмента ИИ

Any MCP Client

Работает с Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex и любым инструментом, совместимым с MCP

Что такое MCP?

Model Context Protocol (MCP) — это представленный Anthropic стандарт с открытым исходным кодом, который позволяет моделям ИИ безопасно подключаться к внешним источникам данных, инструментам и API. Он использует клиент-серверную архитектуру, в которой хост (например, Claude) подключается к серверу MCP, позволяя ИИ выполнять запросы к базам данных, вызывать API или выполнять действия через универсальный стандартизированный интерфейс. Почему это важно для Helius: MCP предоставляет Claude прямой доступ к актуальным данным Solana и инфраструктуре Helius: балансам, метаданным активов, разобранным транзакциям, управлению вебхуками, потоковой передаче данных и многому другому. Без него Claude приходится угадывать содержимое ответов API или многократно выполнять запросы curl для получения контекста. MCP позволяет Claude фактически взаимодействовать с Solana через Helius с помощью структурированных вызовов инструментов.

Сайт документации Helius по адресу helius.dev/docs также предоставляет отдельный сервер MCP, автоматически созданный Mintlify. Этот сервер предназначен только для поиска по документации. Описанный здесь helius-mcp — это комплексный сервер, охватывающий все функции Helius и Solana.

Быстрый старт

Add the MCP server

claude mcp add helius npx helius-mcp@latest

Или добавьте сервер в конфигурацию хоста MCP (Claude Desktop, Cursor, Windsurf, VS Code и т. д.):

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Configure your API key

Если у вас уже есть ключ:

export HELIUS_API_KEY=YOUR_API_KEY

Или задайте его в Claude, вызвав действие setHeliusApiKey инструмента heliusAccount. Ключи API определяются в следующем порядке:

Вызов действия setHeliusApiKey в рамках сеанса
Переменная среды HELIUS_API_KEY
~/.helius/config.json (задается через Helius CLI)

Если вам нужна новая учетная запись: см. раздел Регистрация ниже.

Start using tools

Задавайте вопросы на естественном языке — нужные инструмент и действие выбираются автоматически:

«Какие NFT принадлежат этому кошельку?»
«Разбери эту транзакцию: 5abc...»
«Получи баланс Gh9ZwEm...»
«Отправь 1 SOL на 7xKp...»
«Создай вебхук для этого адреса»

Подключение к серверу Helius MCP

Выполните следующую команду:

claude mcp add helius npx helius-mcp@latest

Или добавьте в файл .mcp.json своего проекта:

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Проверьте с помощью:

claude mcp list

Хотите установить навыки и MCP за один шаг? Вместо этого установите плагин Helius. Выполните эти команды по отдельности:

/plugin marketplace add helius-labs/core-ai

/plugin install helius@helius-labs

Откройте Settings > Developer > Edit Config и добавьте сервер:

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Перезапустите Claude Desktop, чтобы применить изменения.

Откройте палитру команд (Cmd/Ctrl + Shift + P), найдите MCP: Add Server и укажите:

Имя: helius
Команда: npx helius-mcp@latest

Или добавьте в файл .cursor/mcp.json своего проекта:

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Создайте файл .vscode/mcp.json в корневом каталоге проекта:

{
  "servers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Требуется расширение GitHub Copilot с включенной поддержкой MCP.

Откройте палитру команд (Cmd/Ctrl + Shift + P), найдите Configure MCP Servers и добавьте:

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Выполните следующую команду:

codex mcp add helius -- npx helius-mcp@latest

Или добавьте в ~/.codex/config.toml (либо в .codex/config.toml для области проекта):

[mcp_servers.helius]
command = "npx"
args = ["helius-mcp@latest"]

Проверьте с помощью:

codex mcp list

Общедоступные инструменты

Helius MCP предоставляет 10 общедоступных инструментов: 9 маршрутизируемых инструментов, сгруппированных по предметным областям, и expandResult. Каждое действие Helius и Solana доступно в виде аргумента action соответствующего маршрутизируемого инструмента.

Инструмент	Область применения
`heliusAccount`	Настройка учетной записи, аутентификация, тарифы, выставление счетов
`heliusWallet`	Балансы кошельков, активы, история, идентификация
`heliusAsset`	Активы, NFT, коллекции, держатели токенов
`heliusTransaction`	Разбор транзакций и история транзакций кошелька
`heliusChain`	Состояние блокчейна, счета токенов, блоки, состояние сети, счета программ
`heliusStreaming`	CRUD-операции с вебхуками и конфигурация подписок (WebSockets, LaserStream)
`heliusKnowledge`	Документация, руководства, цены, устранение неполадок, исходный код, блог, SIMD
`heliusWrite`	Переводы токенов SOL и SPL
`heliusCompression`	Доказательства Меркла для сжатых NFT
`expandResult`	Развертывание результатов, сначала представленных в виде сводки, по `resultId`

Full Tool Catalog

Все действия, сгруппированные по маршрутизируемым инструментам, с подробным описанием формата вызовов и использования expandResult

Формат вызова маршрутизируемого инструмента

Все 9 маршрутизируемых инструментов имеют общий формат:

action — имя запускаемого действия Helius, например getBalance или createWebhook
параметры предметной области — например, address, signatures или webhookURL
необязательный detail — summary, standard или full
поля телеметрии — _feedback, _feedbackTool, _model

Пример вызова:

{
  "name": "heliusWallet",
  "arguments": {
    "action": "getBalance",
    "address": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
    "_feedback": "initial balance check",
    "_feedbackTool": "heliusWallet.getBalance",
    "_model": "your-model-id"
  }
}

Ответы со сводкой в начале и `expandResult`

Объемные ответы сначала содержат сводку. Маршрутизируемые инструменты возвращают компактную сводку и resultId, если полный ответ слишком велик или если запрошен detail: "summary". Используйте expandResult с этим resultId, чтобы по запросу получить определенный раздел, диапазон, страницу или следующий фрагмент. Это сокращает расход токенов при исследовательских запросах, при этом позволяя агентам при необходимости изучать полную полезную нагрузку.

Регистрация

Создайте учетную запись Helius из своего инструмента ИИ через размещенную платежную ссылку или оплатите USDC непосредственно с помощью локальной пары ключей. Процесс регистрации выполняется через маршрутизируемый инструмент heliusAccount:

Generate a keypair

ИИ вызывает heliusAccount с action: "generateKeypair" — создается кошелек Solana и возвращается его адрес.

Create the payment intent

ИИ вызывает heliusAccount с action: "signup" и mode: "link" — возвращается paymentUrl (например, https://dashboard.helius.dev/pay/<id>), который пользователь открывает для оплаты с любого кошелька. Или передайте mode: "autopay", чтобы автоматически отправить USDC из локальной пары ключей (на кошельке должно быть около 0,001 SOL и сумма тарифа в USDC).

Resume after payment

После оплаты по ссылке ИИ вызывает heliusAccount с action: "signup" и mode: "resume" — проверяется статус платежного намерения, завершается подготовка учетной записи и автоматически настраивается ключ API.

Контактные данные: для каждой новой регистрации, включая тариф Agent, требуются email, firstName и lastName. Кошелек используется только для оплаты. Для upgradePlan требуются те же данные.

То же самое можно сделать из терминала с помощью Helius CLI:

npx helius-cli@latest keygen
npx helius-cli@latest signup --plan agent --email you@example.com --first-name Jane --last-name Doe   # Print hosted payment link
# (pay in browser, then:)
npx helius-cli@latest signup --resume         # Finalize account
# Or autopay from the local keypair:
npx helius-cli@latest signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe

Конфигурация сети

По умолчанию сервер MCP использует mainnet-beta. Переключитесь на devnet с помощью переменной среды:

export HELIUS_NETWORK=devnet

Или вызовите действие setNetwork инструмента heliusAccount в рамках сеанса.

Системные промпты

Пакет helius-mcp поставляется с готовыми системными промптами, которые обучают модели ИИ эффективно использовать инструменты Helius. Они находятся в system-prompts/:

system-prompts/
├── helius/              # Core Helius skill
├── helius-phantom/      # Phantom frontend skill
├── helius-jupiter/      # Jupiter DeFi skill
├── helius-dflow/        # DFlow trading skill
├── helius-okx/          # OKX trading & intelligence skill
└── svm/                 # SVM architecture skill

Каждый из них содержит три варианта:

openai.developer.md — для API OpenAI Responses/Chat Completions (сообщение developer)
claude.system.md — для API Claude (системный промпт)
full.md — автономный вариант со всеми встроенными ссылочными материалами (Cursor Rules, ChatGPT и т. д.)

Примеры кода см. в руководстве по интеграции helius-skills/SYSTEM-PROMPTS.md.

Навыки

Навыки — это наборы экспертных инструкций, которые обучают Claude направлять ваши запросы к нужным действиям MCP и справочным файлам. Они не ограничиваются доступом к инструментам: в них входят логика маршрутизации, правильные шаблоны SDK и правила, предотвращающие распространенные ошибки.

Skills Overview

Доступно шесть навыков: Build (общая разработка для Solana), Phantom (интерфейсные dApp), Jupiter (DeFi), DFlow (торговые приложения), OKX (торговля и аналитика) и SVM (внутреннее устройство протокола)

Дополнительные сведения

Claude Code Plugin

Установка MCP и навыков одним действием

Helius CLI

Управление учетной записью из командной строки

MCP Specification

Узнайте больше о стандарте Model Context Protocol

helius-mcp on npm

Сведения о пакете и история версий

Changelog

История версий и примечания к выпускам

Contribute

Руководство по внесению изменений в helius-mcp

9 Routed Tools

Account Signup

Real-Time Data

Any MCP Client

​Что такое MCP?

​Быстрый старт

​Подключение к серверу Helius MCP

​Общедоступные инструменты

Full Tool Catalog

​Формат вызова маршрутизируемого инструмента

​Ответы со сводкой в начале и expandResult

​Регистрация

​Конфигурация сети

​Системные промпты

​Навыки

Skills Overview

​Дополнительные сведения

Claude Code Plugin

Helius CLI

MCP Specification

helius-mcp on npm

Changelog

Contribute

Что такое MCP?

Быстрый старт

Подключение к серверу Helius MCP

Общедоступные инструменты

Формат вызова маршрутизируемого инструмента

Ответы со сводкой в начале и `expandResult`

Регистрация

Конфигурация сети

Системные промпты

Навыки

Дополнительные сведения