Thirdweb MCP Server

Servidor MCP de Thirdweb

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) para la integración de servicios de thirdweb. Este servidor le permite integrar las herramientas de thirdweb con cualquier cliente compatible con MCP.

Descripción general

Thirdweb MCP proporciona una interfaz unificada para acceder al conjunto de herramientas y servicios blockchain de thirdweb a través del Protocolo de Contexto de Modelo estandarizado. Soporta múltiples transportes de comunicación y puede integrarse con varios servicios de thirdweb:

• Nebula: Ejecución autónoma en cadena: análisis en cadena en tiempo real, generación de código e interacciones con contratos
• Insight: Capacidades de análisis de datos blockchain para datos en cadena en tiempo real
• Engine: Integración con la infraestructura backend de thirdweb para despliegues e interacciones de contratos
• EngineCloud: Operaciones de motor basadas en la nube para billeteras de servidor, interacciones con contratos y gestión de transacciones
• Storage: Capacidades de almacenamiento descentralizado para subir y recuperar datos a través de IPFS

Instalación

Requisitos previos

• Python 3.10 o superior
• uv

Ejecutar con uvx

THIRDWEB_SECRET_KEY=... \
    uvx thirdweb-mcp

Instalar y ejecutar con pipx

pipx install thirdweb-mcp

THIRDWEB_SECRET_KEY=... \
    thirdweb-mcp

Instalar desde el código fuente

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

Configuración

El servidor MCP de thirdweb requiere configuración según los servicios que desee habilitar:

1. Clave secreta de thirdweb: Necesaria para los servicios Nebula, Insight, Storage y EngineCloud. Obténgala desde el panel de thirdweb.
2. IDs de cadena: Identificadores de red blockchain a los que conectarse (ej., 1 para la red principal de Ethereum, 137 para Polygon).
3. Configuración de Engine: Si utiliza el servicio Engine, necesitará la URL de Engine y el JWT de autenticación.
4. Configuración de EngineCloud: Para operaciones de EngineCloud, puede necesitar el Token de Acceso a la Bóveda para operaciones de billetera de servidor.

Puede proporcionarlos mediante opciones de línea de comandos o variables de entorno.

Uso

Opciones de línea de comandos

# 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

Variables de entorno

También puede configurar el servidor MCP usando variables de entorno:

• THIRDWEB_SECRET_KEY: Su clave secreta de API de thirdweb
• THIRDWEB_ENGINE_URL: URL del endpoint para el servicio Engine de thirdweb
• THIRDWEB_ENGINE_AUTH_JWT: Token JWT de autenticación para Engine
• THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS: Dirección de billetera para el backend de Engine
• THIRDWEB_VAULT_ACCESS_TOKEN: Token de acceso a la bóveda para operaciones de billetera de servidor de EngineCloud

Integración con Claude Desktop

Para añadir este servidor MCP a Claude Desktop:

1. Instale el MCP: pipx install thirdweb-mcp

2. Cree o edite el archivo de configuración de Claude Desktop en:

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

3. Añada la siguiente configuración:

   {
     "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. Reinicie Claude Desktop para que los cambios surtan efecto.

Lea más en Inicio rápido de MCP

Integración con clientes MCP

Este servidor puede integrarse con cualquier cliente que soporte el Protocolo de Contexto de Modelo:

1. Ejecute el servidor MCP con la configuración apropiada
2. Conecte su cliente MCP al servidor usando el transporte seleccionado (stdio o SSE)
3. Acceda a los servicios de thirdweb a través de las herramientas MCP expuestas

Servicios disponibles

Nebula

Ejecución y análisis autónomo en cadena:

• Analizar código de contratos inteligentes
• Interacciones y despliegues de contratos
• Ejecución autónoma de tareas en cadena

Insight

Ofrece capacidades de análisis de datos blockchain:

• Consultar datos en cadena a través de múltiples redes
• Analizar transacciones, bloques y eventos de contratos inteligentes
• Monitorear actividades de billeteras y movimientos de tokens

Engine

Se integra con la infraestructura backend de thirdweb:

• Desplegar contratos inteligentes
• Interactuar con contratos desplegados
• Gestionar conexiones de billeteras y transacciones

EngineCloud

Operaciones de motor basadas en la nube con capacidades avanzadas:

• Crear y gestionar billeteras de servidor con integración KMS
• Leer y escribir en contratos inteligentes
• Enviar transacciones y consultar historial de transacciones
• Verificar saldos de tokens nativos en varias cadenas

Storage

Proporciona funcionalidad de almacenamiento descentralizado:

• Subir archivos, directorios y datos JSON a IPFS
• Recuperar contenido de IPFS usando el gateway de thirdweb
• Preservar estructuras de directorios al subir

Licencia

Licencia Apache-2.0

Soporte

Para preguntas o soporte, por favor contacte [email protected] o visite thirdweb.com.