Thirdweb

Thirdweb MCP-Server

Eine Model-Context-Protocol-(MCP)-Server-Implementierung für die Integration von Thirdweb-Diensten. Dieser Server ermöglicht es Ihnen, die Tools von Thirdweb mit jedem MCP-kompatiblen Client zu integrieren.

Überblick

Thirdweb MCP bietet eine einheitliche Schnittstelle für den Zugriff auf die Blockchain-Tools und -Dienste von Thirdweb über das standardisierte Model Context Protocol. Es unterstützt mehrere Kommunikationstransporte und kann mit verschiedenen Thirdweb-Diensten integriert werden:

• Nebula: Autonome Onchain-Ausführung – Echtzeit-Onchain-Analyse, Codegenerierung und Vertragsinteraktionen
• Insight: Blockchain-Datenanalysefunktionen für Echtzeit-Onchain-Daten
• Engine: Integration mit der Backend-Infrastruktur von Thirdweb für Vertragsbereitstellungen und -interaktionen
• EngineCloud: Cloud-basierte Engine-Operationen für Server-Wallets, Vertragsinteraktionen und Transaktionsverwaltung
• Storage: Dezentrale Speicherfunktionen zum Hochladen und Abrufen von Daten über IPFS

Installation

Voraussetzungen

• Python 3.10 oder höher
• uv

Ausführen mit uvx

THIRDWEB_SECRET_KEY=... \
    uvx thirdweb-mcp

Installieren und ausführen mit pipx

pipx install thirdweb-mcp

THIRDWEB_SECRET_KEY=... \
    thirdweb-mcp

Aus dem Quellcode installieren

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

Konfiguration

Der Thirdweb MCP-Server erfordert eine Konfiguration, die darauf basiert, welche Dienste Sie aktivieren möchten:

1. Thirdweb Secret Key: Erforderlich für Nebula, Insight, Storage und EngineCloud-Dienste. Erhältlich über das Thirdweb-Dashboard.
2. Chain-IDs: Blockchain-Netzwerk-IDs, zu denen eine Verbindung hergestellt werden soll (z. B. 1 für Ethereum-Mainnet, 137 für Polygon).
3. Engine-Konfiguration: Wenn Sie den Engine-Dienst nutzen, benötigen Sie die Engine-URL und das Authentifizierungs-JWT.
4. EngineCloud-Konfiguration: Für EngineCloud-Operationen benötigen Sie möglicherweise das Vault Access Token für Server-Wallet-Operationen.

Sie können diese über Befehlszeilenoptionen oder Umgebungsvariablen bereitstellen.

Nutzung

Befehlszeilenoptionen

# 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

Umgebungsvariablen

Sie können den MCP-Server auch über Umgebungsvariablen konfigurieren:

• THIRDWEB_SECRET_KEY: Ihr Thirdweb-API-Secret-Key
• THIRDWEB_ENGINE_URL: URL-Endpunkt für den Thirdweb-Engine-Dienst
• THIRDWEB_ENGINE_AUTH_JWT: Authentifizierungs-JWT-Token für Engine
• THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS: Wallet-Adresse für das Engine-Backend
• THIRDWEB_VAULT_ACCESS_TOKEN: Vault Access Token für EngineCloud-Server-Wallet-Operationen

Integration mit Claude Desktop

So fügen Sie diesen MCP-Server zu Claude Desktop hinzu:

1. Installieren Sie den MCP: pipx install thirdweb-mcp

2. Erstellen oder bearbeiten Sie die Claude-Desktop-Konfigurationsdatei unter:

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

3. Fügen Sie die folgende Konfiguration hinzu:

   {
     "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. Starten Sie Claude Desktop neu, damit die Änderungen wirksam werden.

Lesen Sie mehr im MCP-Schnellstart

Integration mit MCP-Clients

Dieser Server kann mit jedem Client integriert werden, der das Model Context Protocol unterstützt:

1. Führen Sie den MCP-Server mit der entsprechenden Konfiguration aus
2. Verbinden Sie Ihren MCP-Client über den ausgewählten Transport (stdio oder SSE) mit dem Server
3. Greifen Sie über die bereitgestellten MCP-Tools auf die Thirdweb-Dienste zu

Verfügbare Dienste

Nebula

Autonome Onchain-Ausführung und -Analyse:

• Analyse von Smart-Contract-Code
• Vertragsinteraktionen und -bereitstellungen
• Autonome Ausführung von Onchain-Aufgaben

Insight

Bietet Blockchain-Datenanalysefunktionen:

• Abfrage von Onchain-Daten über mehrere Netzwerke hinweg
• Analyse von Transaktionen, Blöcken und Smart-Contract-Ereignissen
• Überwachung von Wallet-Aktivitäten und Token-Bewegungen

Engine

Integriert sich in die Backend-Infrastruktur von Thirdweb:

• Bereitstellung von Smart Contracts
• Interaktion mit bereitgestellten Verträgen
• Verwaltung von Wallet-Verbindungen und Transaktionen

EngineCloud

Cloud-basierte Engine-Operationen mit erweiterten Funktionen:

• Erstellen und Verwalten von Server-Wallets mit KMS-Integration
• Lesen aus und Schreiben in Smart Contracts
• Senden von Transaktionen und Abfragen des Transaktionsverlaufs
• Überprüfen von nativen Token-Guthaben auf verschiedenen Chains

Storage

Bietet dezentrale Speicherfunktionen:

• Hochladen von Dateien, Verzeichnissen und JSON-Daten auf IPFS
• Abrufen von Inhalten aus IPFS über das Thirdweb-Gateway
• Beibehaltung von Verzeichnisstrukturen beim Hochladen

Lizenz

Apache-2.0-Lizenz

Support

Bei Fragen oder für Unterstützung kontaktieren Sie bitte support@thirdweb.com oder besuchen Sie thirdweb.com.