Stagehand MCP Server

Qu'est-ce que le serveur Stagehand MCP ?

Le serveur Stagehand MCP fait le lien entre les applications IA et les tâches d'automatisation Web du monde réel. En exposant les contrôles du navigateur Web sous forme d'outils MCP, il permet aux modèles de langage de grande taille de naviguer sur des sites Web, d'effectuer des tâches et de collecter des données de manière programmatique. Il utilise Browserbase pour la navigation à distance et sans interface graphique, et s'intègre directement avec Claude Desktop, rendant l'automatisation sophistiquée du navigateur accessible aux flux de travail basés sur les LLM.

Comment configurer

1. Clonez le dépôt du serveur Stagehand MCP depuis sa source officielle.
2. Dans le répertoire du projet, installez les dépendances avec :

   npm install
   npm run build
   

3. Mettez à jour votre configuration de Claude Desktop pour enregistrer le serveur Stagehand MCP :

   {
     "mcpServers": {
       "stagehand": {
         "command": "node",
         "args": ["path/to/mcp-server-browserbase/stagehand/dist/index.js"],
         "env": {
           "BROWSERBASE_API_KEY": "<VOTRE_BROWSERBASE_API_KEY>",
           "BROWSERBASE_PROJECT_ID": "<VOTRE_BROWSERBASE_PROJECT_ID>",
           "OPENAI_API_KEY": "<VOTRE_OPENAI_API_KEY>"
         }
       }
     }
   }
   

4. Exécutez le serveur avec :

   node dist/index.js
   

5. Redémarrez Claude Desktop pour charger la nouvelle configuration MCP. Les outils Stagehand apparaîtront ensuite comme outils MCP disponibles.

Comment utiliser

• Lancez Claude Desktop avec le serveur MCP configuré.
• Accédez aux outils Stagehand depuis le menu des outils MCP disponibles (cherchez l'icône du marteau).
• Utilisez des outils comme la navigation de site, l'automatisation des actions et l'extraction de données en sélectionnant l'outil pertinent, en entrant les paramètres requis (par exemple, URLs, actions, instructions) et en exécutant la fonction.
• Consultez les ressources telles que les journaux de la console ou les captures d'écran via leurs points de terminaison de ressources respectifs lorsque nécessaire.
• Pour une démonstration visuelle, référez-vous à la documentation disponible ou aux vidéos de démonstration montrant Claude interagissant avec le Web via le serveur Stagehand MCP.

Fonctionnalités clés

• Outils d'automatisation Web standardisés facilement accessibles dans Claude Desktop via MCP.
• Intégration sécurisée avec Browserbase pour des sessions de navigateur à distance et sans interface.
• Ensemble d'outils exécutables : naviguer sur des sites Web, effectuer des actions, extraire des données structurées.
• Les points de terminaison de ressources fournissent des journaux de la console du navigateur et des captures d'écran à la demande pour une traçabilité complète.
• Prend en charge des identifiants personnalisés et une isolation environnementale pour des tâches sensibles et des opérations sécurisées.

Cas d'utilisation

• Collecte automatisée de données à partir de pages Web pour des informations à jour.
• Automatisation de flux de travail de bout en bout, comme se connecter à des sites, naviguer sur des tableaux de bord et télécharger des rapports.
• Prototypage rapide de flux de travail agentiques basés sur le navigateur alimentés par des LLM.
• Surveillance et scraping de contenu Web public avec extraction en temps réel via une automation dirigée par LLM.
• Collecte de captures d'écran et de journaux de diagnostic pour la conformité ou le reporting.

FAQ

Q1 : Dois-je exposer mes fichiers locaux ou ma base de données pour utiliser le serveur Stagehand MCP ?

Non, le serveur Stagehand MCP interagit uniquement avec des ressources Web et fournit un accès aux sessions de navigateur, captures d'écran et journaux. Vos fichiers et bases de données locaux restent isolés sauf intégration explicite via d'autres serveurs MCP.

Q2 : De quoi ai-je besoin de Browserbase ?

Vous aurez besoin d'une clé API Browserbase et d'un ID de projet. Ces identifiants sont nécessaires pour instancier des sessions de navigateur sécurisées et à distance.

Q3 : Comment savoir si le serveur Stagehand MCP fonctionne correctement ?

Après avoir lancé le serveur et redémarré Claude Desktop, vous devriez voir les outils Stagehand apparaître comme des outils MCP appelables. De plus, vérifiez la sortie de la ligne de commande du serveur pour une confirmation de connexion ou des erreurs.

Q4 : Puis-je utiliser le serveur Stagehand MCP avec d'autres hôtes LLM en plus de Claude Desktop ?

Actuellement, l'intégration officielle principale se fait avec Claude Desktop, mais tout hôte prenant en charge le protocole MCP et les outils pourrait potentiellement exploiter le serveur Stagehand MCP.

Q5 : Est-il possible de capturer des captures d'écran ou d'accéder aux journaux du navigateur de manière programmatique ?

Oui, les captures d'écran et les journaux de la console du navigateur sont exposés comme des ressources accessibles via leurs identifiants de ressources uniques, facilitant la récupération de preuves ou le débogage des résultats de manière programmatique.