Как подключить Helius к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Helius, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Helius + Gemini

Данные блокчейна Solana через Helius: балансы SOL и токенов, NFT и токены кошелька (DAS API), понятная история транзакций, отдельные транзакции, принадлежность кошелька и источник его финансирования. Только чтение.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

HELIUS_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен аккаунт Helius; тарифа Free достаточно.

1. Зарегистрируйтесь на https://dashboard.helius.dev.
2. Откройте API Keys и скопируйте ключ в HELIUS_API_KEY: только ключ (UUID вида 1a2b3c4d-...), а не весь RPC URL. Он передаётся как параметр запроса api-key.
3. Установите коннектор и запустите helius_get_epoch_info: он покажет текущую эпоху Solana, слот и высоту блока, то есть подтвердит, что ключ работает.

Что он читает: mainnet Solana через Helius, используя стандартный Solana RPC, DAS API для NFT и токенов, Enhanced Transactions для понятной истории и Wallet API (бета). Это баланс SOL аккаунта; всё, что хранится в кошельке (NFT, сжатые NFT, токены SPL и Token-2022 с балансом, числом знаков после запятой и ценой, если она известна, плюс SOL); отдельный актив или токен по адресу mint с метаданными, коллекцией, роялти, создателями и эмиссией; токен-аккаунты по владельцу или по mint; подписи транзакций адреса и отдельные транзакции с разобранными инструкциями, балансами и логами; понятная история с типами вроде TRANSFER, SWAP или NFT_SALE; портфель кошелька в USD, изменения баланса по каждой транзакции и входящие и исходящие переводы; а также кому принадлежит известный кошелёк (биржи, протоколы, организации, в том числе по домену .sol) и кто первым пополнил его SOL.

Единицы и время: суммы SOL из RPC указаны в lamports, 1 000 000 000 на SOL. Суммы токенов из токен-аккаунтов — необработанные целые числа, которые ИИ делит на 10^decimals соответствующего mint. blockTime и timestamp — секунды Unix (UTC), и ИИ пересчитывает их, прежде чем назвать время. Цены в USD в Wallet API — почасовые оценки примерно для 10 000 крупнейших токенов и могут отсутствовать.

Кредиты: у каждого тарифа Helius есть месячные кредиты (Free: 1 миллион). Стандартный вызов RPC стоит 1 кредит, вызовы DAS и Enhanced дороже, каждый вызов Wallet API — 100 кредитов. Для обычных вопросов ИИ использует инструменты RPC и DAS, а Wallet API — только для того, на что отвечает лишь он: стоимость в USD, принадлежность и первый отправитель средств.

Только чтение: каждый инструмент только читает, поэтому подтверждать нечего и ни один инструмент не отключён при установке. Ни одна транзакция не подписывается и не отправляется; helius_parse_transactions лишь превращает подписи в понятные транзакции.

Ограничения: на тарифе Free RPC допускает 10 запросов в секунду, API DAS и Enhanced — 2 в секунду. История приходит до 100 записей за вызов (необработанные подписи до 1 000), и ИИ листает дальше по последней полученной подписи или курсору. Настроен только mainnet. Enhanced Transactions у Helius находится в режиме поддержки, а Wallet API в бета-версии, поэтому их форматы могут меняться.

Частые ошибки: 401 означает отсутствующий или неверный API-ключ, часто вместо ключа вставлен весь RPC URL. 429 означает, что исчерпан лимит запросов тарифа или месячные кредиты; проверьте расход в панели Helius. Ошибки RPC возвращаются объектом JSON-RPC error, например при неверном адресе. Wallet API отвечает 404, если не знает принадлежности или первого отправителя средств для кошелька.

Коннектор не подписывает и не отправляет транзакции, не настраивает вебхуки и потоки, не оценивает priority fees и не читает devnet.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Helius.

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

Примеры запросов

• «Что хранится в этом кошельке Solana? Перечислите SOL, токены и NFT с количествами.»
• «Покажите последние 20 транзакций этого кошелька простыми словами: свопы, переводы и продажи NFT.»
• «Сколько сейчас стоит в USD портфель токенов этого кошелька?»
• «Чей это кошелёк и кто первым пополнил его SOL?»
• «Найдите этот mint токена: название, символ, число знаков, эмиссию и цену.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot