avalanche-mcp-server

Установка

Хостинг — ничего устанавливать не нужно. Та же форма, что и у build.avax.network/api/mcp от Ava Labs: публичная конечная точка Streamable HTTP, без API-ключа.

claude mcp add avalanche --transport http https://avalanche-mcp.dev/mcp

Запустите /mcp в Claude Code, чтобы проверить — вы должны увидеть avalanche · 41 инструмент.

Related MCP server: Somnia MCP Server

Что он делает

Спрашивайте на простом языке; агент выбирает инструменты и указывает источники.

› What changes in the Helicon upgrade for my C-Chain indexer?

⏺ avax_upgrade_lookup(query: "Helicon")
⏺ avax_acp_lookup(query: "ACP-194")
⏺ avax_get_doc(content/docs/primary-network/helicon-upgrade.mdx)

Helicon (AvalancheGo v1.15.0-fuji) is live on Fuji since 2026-07-28; mainnet is not
scheduled yet. ACP-194 Continuous Execution decouples consensus from execution, so a
block's state root settles after a τ delay (~5 s) — don't treat "latest" as executed
state. ACP-283 makes the minimum gas price dynamic, so never hardcode a fee floor.

Sources: build.avax.network/docs/primary-network/helicon-upgrade
         build.avax.network/docs/acps/194-continuous-execution

Другие вопросы на первый день:

• "Спланируйте разрешённую корпоративную L1 на Fuji с пятью валидаторами, затем сгенерируйте genesis."

• "Объясните прекомпилят NativeMinter и как включить его после запуска с помощью upgrade.json."

• "Отправьте сообщение из Fuji C-Chain в Dispatch с помощью Teleporter, с настройкой релеера."

• "Какие ACP активированы, и что меняет ACP-176 в отношении газа?"

• "Мой CLI говорит subnet not tracked, когда я обращаюсь к RPC. Что не так?"

Возможности

41 инструмент, все только для чтения. Ничто не подписывает и не транслирует транзакции.

Плюс MCP ресурсы (avax://docs/{path}, avax://guides/{name}, avax://networks) и подсказки (avalanche_launch_l1, avalanche_deploy_contract, avalanche_icm_bridge, avalanche_learn). Полный список инструментов доступен на avalanche-mcp.dev/#tools или через tools/list.

Проверено, а не угадано

Факты, в которых модели часто ошибаются, зафиксированы в коде и проверены по документации: минимальная базовая комиссия C-Chain составляет 1 wei начиная с Fortuna (ACP-176), а не 25 nAVAX; subnet-evm и icm-contracts теперь находятся в avalanchego/graft и icm-services; Helicon доступен только на Fuji с августа 2026 года. Каждый ответ содержит URL build.avax.network или GitHub, из которого он взят.

Источники знаний

Индекс создаётся командой npm run build-index из официальных репозиториев и поставляется внутри пакета, поэтому первый поиск работает офлайн:

avax_list_topics сообщает дату сборки индекса, чтобы агент знал, насколько он свежий; avax_fetch_live_doc получает текущую версию любой страницы, когда это важно. Строки, похожие на учётные данные, в примерах документации удаляются при сборке.

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

Конфигурация не требуется. Дополнительные переменные окружения (локальный режим):

Самостоятельный хостинг

Запустите HTTP-транспорт в любом месте, где работает Node:

npx -y avalanche-mcp-server --http        # POST http://localhost:3333/mcp  (PORT to change)

Или подключите его в любой веб-стандартной среде выполнения — обработчики маршрутов Next.js, Cloudflare Workers, Hono:

import { handleMcpRequest } from "avalanche-mcp-server";
export const POST = (req: Request) => handleMcpRequest(req);

Именно так avalanche-mcp.dev обслуживает его (исходный код). Ответы — это статeless JSON с открытым CORS, поэтому браузерные клиенты тоже работают.

Работает с официальными Avalanche MCP

Хостинговый MCP от Ava Labs всегда актуален для поиска по Builder Hub, поиска CLI / RPC и сценариев; этот сервер добавляет офлайн-знания, структурированные ACP и обновления, живые инструменты EVM и сквозные рабочие процессы. Они сочетаются:

claude mcp add avalanche          --transport http https://avalanche-mcp.dev/mcp
claude mcp add avalanche-hosted   --transport http https://build.avax.network/api/mcp
claude mcp add avalanche-chainkit -- npx -y @avalanche-sdk/chainkit mcp-server
claude mcp add avalanche-avacloud -- npx -y @avalabs/avacloud-sdk mcp-server --apikey $AVACLOUD_API_KEY

avax_hosted_call уже проксирует хостинговый сервер изнутри этого, так что одной регистрации достаточно для большинства конфигураций.

Разработка

git clone https://github.com/Eelvanpsd/Avalanche-mcp.git && cd Avalanche-mcp
npm install && npm run build       # the index ships in the repo
npm run dev                        # stdio server via tsx
npm run inspect                    # MCP Inspector UI
npx tsx scripts/smoke.ts           # end-to-end tool check over stdio
REFRESH=1 npm run build-index      # re-download sources and rebuild the index

Расширение — по одному файлу на каждый аспект: подобранные руководства в src/knowledge/guides.ts, реестр сетей в src/config/networks.ts, временная шкала обновлений в src/knowledge/upgrades.ts, новые источники в scripts/build-index.ts.

Лицензия

MIT. Avalanche MCP — независимый проект, созданный сообществом, и не аффилирован с Ava Labs или Avalanche Foundation и не одобрен ими. Avalanche и знак Avalanche являются товарными знаками их соответствующих владельцев.