Thirdweb

Servidor MCP thirdweb

Uma implementação de servidor Model Context Protocol (MCP) para integração com serviços thirdweb. Este servidor permite integrar as ferramentas da thirdweb com qualquer cliente compatível com MCP.

Visão Geral

O MCP thirdweb fornece uma interface unificada para acessar o conjunto de ferramentas e serviços blockchain da thirdweb por meio do protocolo padronizado Model Context Protocol. Ele oferece suporte a múltiplos transportes de comunicação e pode ser integrado a vários serviços thirdweb:

• Nebula: Execução onchain autônoma - análise on-chain em tempo real, geração de código e interações com contratos
• Insight: Capacidades de análise de dados blockchain para dados on-chain em tempo real
• Engine: Integração com a infraestrutura de backend da thirdweb para implantações e interações com contratos
• EngineCloud: Operações de engine baseadas em nuvem para carteiras de servidor, interações com contratos e gerenciamento de transações
• Storage: Capacidades de armazenamento descentralizado para upload e recuperação de dados via IPFS

Instalação

Pré-requisitos

• Python 3.10 ou superior
• uv

Executar com uvx

THIRDWEB_SECRET_KEY=... \
    uvx thirdweb-mcp

Instalar e executar com pipx

pipx install thirdweb-mcp

THIRDWEB_SECRET_KEY=... \
    thirdweb-mcp

Instalar a partir do código fonte

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

Configuração

O servidor MCP thirdweb requer configuração com base nos serviços que você deseja habilitar:

1. Chave Secreta thirdweb: Necessária para os serviços Nebula, Insight, Storage e EngineCloud. Obtenha no painel thirdweb.
2. IDs de Cadeia: IDs de rede blockchain para conectar (ex.: 1 para Ethereum mainnet, 137 para Polygon).
3. Configuração do Engine: Se estiver usando o serviço Engine, você precisará da URL do Engine e do JWT de autenticação.
4. Configuração do EngineCloud: Para operações do EngineCloud, você pode precisar do Token de Acesso ao Vault para operações de carteira de servidor.

Você pode fornecê-los por meio de opções de linha de comando ou variáveis de ambiente.

Uso

Opções de linha de comando

# 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

Variáveis de ambiente

Você também pode configurar o servidor MCP usando variáveis de ambiente:

• THIRDWEB_SECRET_KEY: Sua chave secreta da API thirdweb
• THIRDWEB_ENGINE_URL: Endpoint URL para o serviço thirdweb Engine
• THIRDWEB_ENGINE_AUTH_JWT: Token JWT de autenticação para o Engine
• THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS: Endereço da carteira para o backend do Engine
• THIRDWEB_VAULT_ACCESS_TOKEN: Token de acesso ao vault para operações de carteira de servidor EngineCloud

Integração com Claude Desktop

Para adicionar este servidor MCP ao Claude Desktop:

1. Instale o MCP: pipx install thirdweb-mcp

2. Crie ou edite o arquivo de configuração do Claude Desktop em:

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

3. Adicione a seguinte configuração:

   {
     "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 o Claude Desktop para que as alterações tenham efeito.

Leia mais em MCP Quickstart

Integração com clientes MCP

Este servidor pode ser integrado a qualquer cliente que ofereça suporte ao Model Context Protocol:

1. Execute o servidor MCP com a configuração apropriada
2. Conecte seu cliente MCP ao servidor usando o transporte selecionado (stdio ou SSE)
3. Acesse os serviços thirdweb por meio das ferramentas MCP expostas

Serviços Disponíveis

Nebula

Execução e análise onchain autônomas:

• Analisar código de contratos inteligentes
• Interações e implantações de contratos
• Execução autônoma de tarefas onchain

Insight

Oferece capacidades de análise de dados blockchain:

• Consultar dados on-chain em múltiplas redes
• Analisar transações, blocos e eventos de contratos inteligentes
• Monitorar atividades de carteiras e movimentações de tokens

Engine

Integra-se com a infraestrutura de backend da thirdweb:

• Implantar contratos inteligentes
• Interagir com contratos implantados
• Gerenciar conexões de carteira e transações

EngineCloud

Operações de engine baseadas em nuvem com capacidades avançadas:

• Criar e gerenciar carteiras de servidor com integração KMS
• Ler e escrever em contratos inteligentes
• Enviar transações e consultar histórico de transações
• Verificar saldos de tokens nativos em várias cadeias

Storage

Fornece funcionalidade de armazenamento descentralizado:

• Fazer upload de arquivos, diretórios e dados JSON para o IPFS
• Recuperar conteúdo do IPFS usando o gateway thirdweb
• Preservar estruturas de diretórios durante o upload

Licença

Licença Apache-2.0

Suporte

Para dúvidas ou suporte, entre em contato com support@thirdweb.com ou visite thirdweb.com.