Alchemy MCP Server

Сервер Model Context Protocol (MCP), который позволяет ИИ-агентам взаимодействовать с API блокчейна Alchemy структурированным образом. Это позволяет агентам запрашивать данные блокчейна напрямую, не написав ни строчки кода.

Удаленный MCP-сервер (рекомендуется)

Самый быстрый способ начать работу — подключиться к размещенному удаленному серверу по адресу https://mcp.alchemy.com/mcp. Аутентификация происходит через OAuth — просто войдите в свою учетную запись Alchemy при появлении запроса. API-ключ или локальная установка не требуются.

Полная документация: alchemy.com/docs/alchemy-mcp-server

Примечание: Размещенный сервер по адресу mcp.alchemy.com и этот репозиторий с открытым исходным кодом поддерживаются отдельно и могут быть не синхронизированы.

{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

{
  "servers": {
    "alchemy": {
      "type": "http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

Для любого другого клиента, совместимого с MCP, укажите адрес https://mcp.alchemy.com/mcp, используя транспорт Streamable HTTP.

Related MCP server: Substrate MCP Server

Локальный STDIO-сервер

Этот MCP-сервер создает мост между ИИ-агентами и API блокчейна Alchemy, позволяя агентам:

• Запрашивать цены на токены и историю цен (включая гибкие запросы по временным интервалам)

• Получать информацию о владении NFT и данные контрактов

• Просматривать историю транзакций в нескольких сетях

• Проверять балансы токенов в нескольких блокчейн-сетях

• Получать подробные данные о переводах активов с фильтрацией

• Отправлять транзакции через аккаунты смарт-контрактов (требуется настроенный сервер агента кошелька)

• Выполнять обмен токенов через протоколы DEX (требуется настроенный сервер агента кошелька)

• И многое другое!

Быстрая настройка

Чтобы быстро настроить MCP-сервер, используйте следующую конфигурацию в вашем файле конфигурации MCP (обычно в настройках Claude Desktop или Cursor):

{
  "mcpServers": {
    "alchemy": {
      "command": "npx",
      "args": ["-y", "@alchemy/mcp-server"],
      "env": {
        "ALCHEMY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Эта конфигурация позволяет использовать сервер без ручного клонирования репозитория.

Переменные окружения

MCP-сервер требует следующую переменную окружения:

• ALCHEMY_API_KEY — ваш API-ключ Alchemy (обязателен для всех запросов данных блокчейна)

Для функциональности транзакций и обмена вы также должны настроить:

• AGENT_WALLET_SERVER — URL настроенного сервера агента кошелька, который обрабатывает операции со смарт-контрактами

⚠️ Важно: Методы sendTransaction и swap не будут работать без правильно настроенного сервера агента кошелька. Эти методы требуют внешней инфраструктуры кошелька для обработки подписи и трансляции транзакций.

Доступные методы

Вы можете попросить своего ИИ-агента использовать следующие методы:

Методы цены токена

1. fetchTokenPriceBySymbol

   • Получает текущие данные о цене токенов по символу

   • Пример: "Какова текущая цена ETH и BTC?"

2. fetchTokenPriceByAddress

   • Получает текущие данные о цене токенов по адресу контракта

   • Пример: "Какова цена токена по адресу 0x1234...5678 в основной сети Ethereum?"

3. fetchTokenPriceHistoryBySymbol

   • Получает исторические данные о цене токенов с указанными диапазонами дат

   • Пример: "Покажи историю цен BTC с 1 января по 1 февраля 2023 года с ежедневными интервалами"

4. fetchTokenPriceHistoryByTimeFrame

   • Получает исторические данные о цене, используя гибкие временные рамки или естественный язык

   • Пример: "Покажи цену ETH за последнюю неделю" или "Получи цену BTC за последние 30 дней"

Мультичейн-методы токенов

5. fetchTokensOwnedByMultichainAddresses

   • Получает балансы токенов для адресов в нескольких сетях

   • Пример: "Какие токены хранятся на 0xabc...123 в Ethereum и Base?"

Методы истории транзакций

6. fetchAddressTransactionHistory

   • Получает историю транзакций для адресов в нескольких сетях

   • Пример: "Покажи недавние транзакции для кошелька 0xdef...456 в Ethereum"

7. fetchTransfers

   • Получает подробные данные о переводе активов с расширенными параметрами фильтрации

   • Пример: "Покажи мне все переводы ERC-20 на или с 0xghi...789"

Методы NFT

8. fetchNftsOwnedByMultichainAddresses

   • Получает все NFT, принадлежащие адресам, с фильтрацией спама

   • Пример: "Какие NFT есть у 0xjkl...012?"

9. fetchNftContractDataByMultichainAddress

   • Получает данные контракта NFT для адресов

   • Пример: "Токены из каких коллекций NFT есть у 0xmno...345?"

Методы транзакций

10. sendTransaction

    • Отправляет транзакции через аккаунты смарт-контрактов

    • ⚠️ Важно: Требуется настроенный сервер агента кошелька с переменной окружения AGENT_WALLET_SERVER

    • Пример: "Отправь 0.1 ETH на 0xpqr...678"

Методы обмена (Swap)

11. swap

    • Выполняет обмен токенов через протоколы DEX (Uniswap)

    • ⚠️ Важно: Требуется настроенный сервер агента кошелька с переменной окружения AGENT_WALLET_SERVER

    • Пример: "Обменяй 100 USDC на ETH"

Локальная разработка и вклад в проект

Установка

1. Клонируйте репозиторий

git clone https://github.com/alchemyplatform/alchemy-mcp.git
cd alchemy-mcp

2. Установите зависимости

pnpm install

Разработка

pnpm watch

Сборка для продакшена

pnpm build

Использование MCP Inspector для отладки

MCP Inspector помогает отлаживать ваш MCP-сервер, предоставляя визуальный интерфейс для тестирования методов:

pnpm inspector

Это запустит MCP Inspector, к которому вы сможете получить доступ в браузере. Он позволяет:

• Видеть все доступные методы

• Тестировать методы с различными параметрами

• Просматривать данные ответа

• Отлаживать проблемы с вашим MCP-сервером

Вклад

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

Лицензия

Этот MCP-сервер лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT.

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

Вот несколько примеров запросов, которые вы можете использовать со своим ИИ-агентом:

What's the current price of Bitcoin and Ethereum?

Show me the NFTs owned by the wallet 0x1234...5678 on Ethereum.

What tokens does wallet 0xabcd...6789 hold across Ethereum and Base?

Get me the transaction history for 0x9876...5432.

Show me the price history of Ethereum from January 1st to today with daily intervals.

Get me Bitcoin price data for the last week with hourly intervals.

Show me ETH price performance for the past month.

What ERC-20 transfers happened to address 0x1234...5678 in the last 100 blocks?

Справочник API

Для получения дополнительной информации об API Alchemy обратитесь к:

• Документация Alchemy API