Thirdweb

Serveur MCP Thirdweb

Une implémentation de serveur Model Context Protocol (MCP) pour l'intégration des services thirdweb. Ce serveur vous permet d'intégrer les outils thirdweb avec n'importe quel client compatible MCP.

Aperçu

Thirdweb MCP fournit une interface unifiée pour accéder à la suite d'outils et services blockchain de thirdweb via le protocole standardisé Model Context Protocol. Il prend en charge plusieurs transports de communication et peut être intégré à divers services thirdweb :

• Nebula : Exécution onchain autonome - analyse on-chain en temps réel, génération de code et interactions avec les contrats
• Insight : Capacités d'analyse de données blockchain pour les données on-chain en temps réel
• Engine : Intégration avec l'infrastructure backend de thirdweb pour les déploiements et interactions de contrats
• EngineCloud : Opérations engine basées sur le cloud pour les portefeuilles serveur, les interactions contractuelles et la gestion des transactions
• Storage : Capacités de stockage décentralisé pour le téléchargement et la récupération de données via IPFS

Installation

Prérequis

• Python 3.10 ou supérieur
• uv

Exécuter avec uvx

THIRDWEB_SECRET_KEY=... \
    uvx thirdweb-mcp

Installer et exécuter avec pipx

pipx install thirdweb-mcp

THIRDWEB_SECRET_KEY=... \
    thirdweb-mcp

Installer depuis la source

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

Configuration

Le serveur MCP thirdweb nécessite une configuration selon les services que vous souhaitez activer :

1. Clé secrète thirdweb : Requise pour les services Nebula, Insight, Storage et EngineCloud. À obtenir depuis le tableau de bord thirdweb.
2. IDs de chaîne : Identifiants de réseau blockchain auxquels se connecter (ex. 1 pour Ethereum mainnet, 137 pour Polygon).
3. Configuration Engine : Si vous utilisez le service Engine, vous aurez besoin de l'URL Engine et du JWT d'authentification.
4. Configuration EngineCloud : Pour les opérations EngineCloud, vous pourriez avoir besoin du jeton d'accès Vault pour les opérations de portefeuille serveur.

Vous pouvez les fournir via les options de ligne de commande ou les variables d'environnement.

Utilisation

Options de ligne de commande

# 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 d'environnement

Vous pouvez également configurer le serveur MCP en utilisant des variables d'environnement :

• THIRDWEB_SECRET_KEY : Votre clé secrète API thirdweb
• THIRDWEB_ENGINE_URL : URL de point de terminaison pour le service thirdweb Engine
• THIRDWEB_ENGINE_AUTH_JWT : Jeton JWT d'authentification pour Engine
• THIRDWEB_ENGINE_BACKEND_WALLET_ADDRESS : Adresse de portefeuille pour le backend Engine
• THIRDWEB_VAULT_ACCESS_TOKEN : Jeton d'accès Vault pour les opérations de portefeuille serveur EngineCloud

Intégration avec Claude Desktop

Pour ajouter ce serveur MCP à Claude Desktop :

1. Installer le MCP : pipx install thirdweb-mcp

2. Créer ou modifier le fichier de configuration 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. Ajouter la configuration suivante :

   {
     "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. Redémarrer Claude Desktop pour que les modifications prennent effet.

En savoir plus sur le Guide de démarrage MCP

Intégration avec les clients MCP

Ce serveur peut être intégré à tout client prenant en charge le Model Context Protocol :

1. Exécuter le serveur MCP avec la configuration appropriée
2. Connecter votre client MCP au serveur en utilisant le transport sélectionné (stdio ou SSE)
3. Accéder aux services thirdweb via les outils MCP exposés

Services disponibles

Nebula

Exécution et analyse onchain autonomes :

• Analyser le code des contrats intelligents
• Interactions et déploiements de contrats
• Exécution autonome de tâches onchain

Insight

Offre des capacités d'analyse de données blockchain :

• Interroger les données on-chain sur plusieurs réseaux
• Analyser les transactions, les blocs et les événements de contrats intelligents
• Surveiller les activités de portefeuille et les mouvements de jetons

Engine

S'intègre à l'infrastructure backend de thirdweb :

• Déployer des contrats intelligents
• Interagir avec les contrats déployés
• Gérer les connexions de portefeuille et les transactions

EngineCloud

Opérations engine basées sur le cloud avec des capacités avancées :

• Créer et gérer des portefeuilles serveur avec intégration KMS
• Lire et écrire dans les contrats intelligents
• Envoyer des transactions et interroger l'historique des transactions
• Vérifier les soldes de jetons natifs sur diverses chaînes

Storage

Fournit des fonctionnalités de stockage décentralisé :

• Télécharger des fichiers, répertoires et données JSON vers IPFS
• Récupérer du contenu depuis IPFS en utilisant la passerelle thirdweb
• Préserver les structures de répertoires lors du téléchargement

Licence

Licence Apache-2.0

Support

Pour toute question ou assistance, veuillez contacter support@thirdweb.com ou visiter thirdweb.com.