Thirdweb

thirdweb MCP-сервер

Реализация сервера Model Context Protocol (MCP) для интеграции сервисов thirdweb. Этот сервер позволяет интегрировать инструменты thirdweb с любым MCP-совместимым клиентом.

Обзор

thirdweb MCP предоставляет унифицированный интерфейс для доступа к набору блокчейн-инструментов и сервисов thirdweb через стандартизированный Model Context Protocol. Он поддерживает несколько транспортных протоколов и может быть интегрирован с различными сервисами thirdweb:

• Nebula: Автономное выполнение onchain-операций — анализ on-chain данных в реальном времени, генерация кода и взаимодействие с контрактами
• Insight: Возможности анализа данных блокчейна для получения on-chain данных в реальном времени
• Engine: Интеграция с бэкенд-инфраструктурой thirdweb для развертывания контрактов и взаимодействия с ними
• EngineCloud: Облачные операции Engine для серверных кошельков, взаимодействия с контрактами и управления транзакциями
• Storage: Возможности децентрализованного хранения для загрузки и получения данных через IPFS

Установка

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

• Python 3.10 или выше
• uv

Запуск с uvx

THIRDWEB_SECRET_KEY=... \
    uvx thirdweb-mcp

Установка и запуск с pipx

pipx install thirdweb-mcp

THIRDWEB_SECRET_KEY=... \
    thirdweb-mcp

Установка из исходного кода

git clone https://github.com/thirdweb-dev/ai.git thirdweb-ai
cd thirdweb-ai/python/thirdweb-mcp
uv sync

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

MCP-сервер thirdweb требует настройки в зависимости от того, какие сервисы вы хотите включить:

1. Секретный ключ thirdweb: Требуется для сервисов Nebula, Insight, Storage и EngineCloud. Получите его в панели управления thirdweb.
2. Идентификаторы цепей (Chain IDs): Идентификаторы блокчейн-сетей для подключения (например, 1 для основной сети Ethereum, 137 для Polygon).
3. Конфигурация Engine: При использовании сервиса Engine вам понадобятся URL Engine и JWT для аутентификации.
4. Конфигурация EngineCloud: Для операций EngineCloud может потребоваться токен доступа к хранилищу (Vault Access Token) для операций с серверным кошельком.

Вы можете указать их через параметры командной строки или переменные окружения.

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

Параметры командной строки

# Basic usage with default settings (stdio transport with Nebula and Insight)
THIRDWEB_SECRET_KEY=... thirdweb-mcp 

# Using SSE transport on a custom port
THIRDWEB_SECRET_KEY=... thirdweb-mcp --transport sse --port 8080

# Enabling all services with specific chain IDs
THIRDWEB_SECRET_KEY=... thirdweb-mcp --chain-id 1 --chain-id 137 \
    --engine-url YOUR_ENGINE_URL \
    --engine-auth-jwt YOUR_ENGINE_JWT \ 
    --engine-backend-wallet-address YOUR_ENGINE_BACKEND_WALLET_ADDRESS \
    --vault-access-token YOUR_VAULT_ACCESS_TOKEN

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

Вы также можете настроить MCP-сервер с помощью переменных окружения:

• THIRDWEB_SECRET_KEY: Ваш секретный ключ API thirdweb
• THIRDWEB_ENGINE_URL: URL-адрес сервиса thirdweb Engine
• THIRDWEB_ENGINE_AUTH_JWT: JWT-токен аутентификации для Engine
• THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS: Адрес кошелька для бэкенда Engine
• THIRDWEB_VAULT_ACCESS_TOKEN: Токен доступа к хранилищу для операций с серверным кошельком EngineCloud

Интеграция с Claude Desktop

Чтобы добавить этот MCP-сервер в Claude Desktop:

1. Установите MCP: pipx install thirdweb-mcp

2. Создайте или отредактируйте файл конфигурации Claude Desktop по пути:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

3. Добавьте следующую конфигурацию:

   {
     "mcpServers": {
       "thirdweb-mcp": {
         "command": "thirdweb-mcp",
         "args": [], // add `--chain-id` optionally
         "env": {
           "THIRDWEB_SECRET_KEY": "your thirdweb secret key from dashboard",
           "THIRDWEB_ENGINE_URL": "(OPTIONAL) your engine url",
           "THIRDWEB_ENGINE_AUTH_JWT": "(OPTIONAL) your engine auth jwt",
           "THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS": "(OPTIONAL) your engine backend wallet address",
           "THIRDWEB_VAULT_ACCESS_TOKEN": "(OPTIONAL) your vault access token for EngineCloud"
         },
       }
     }
   }
   

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

Подробнее в MCP Quickstart

Интеграция с MCP-клиентами

Этот сервер можно интегрировать с любым клиентом, поддерживающим Model Context Protocol:

1. Запустите MCP-сервер с соответствующей конфигурацией
2. Подключите ваш MCP-клиент к серверу, используя выбранный транспорт (stdio или SSE)
3. Получите доступ к сервисам thirdweb через предоставленные инструменты MCP

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

Nebula

Автономное выполнение и анализ onchain-операций:

• Анализ кода смарт-контрактов
• Взаимодействие с контрактами и их развертывание
• Автономное выполнение onchain-задач

Insight

Предоставляет возможности анализа данных блокчейна:

• Запрос on-chain данных в нескольких сетях
• Анализ транзакций, блоков и событий смарт-контрактов
• Мониторинг активности кошельков и перемещения токенов

Engine

Интегрируется с бэкенд-инфраструктурой thirdweb:

• Развертывание смарт-контрактов
• Взаимодействие с развернутыми контрактами
• Управление подключениями кошельков и транзакциями

EngineCloud

Облачные операции Engine с расширенными возможностями:

• Создание и управление серверными кошельками с интеграцией KMS
• Чтение и запись в смарт-контракты
• Отправка транзакций и запрос истории транзакций
• Проверка балансов нативных токенов в различных сетях

Storage

Предоставляет функциональность децентрализованного хранения:

• Загрузка файлов, директорий и данных JSON в IPFS
• Получение контента из IPFS с использованием шлюза thirdweb
• Сохранение структур директорий при загрузке

Лицензия

Лицензия Apache-2.0

Поддержка

По вопросам или для получения поддержки обращайтесь по адресу support@thirdweb.com или посетите thirdweb.com.