Premiers pas Comparaison Recettes
Serveur MCP de CloakBrowser¶
cloakbrowser-mcp est un serveur d’automatisation de navigateur compatible Playwright MCP en drop-in, avec outils amont inchangés, CloakBrowser Chromium et packaging prêt pour npm, Docker et Streamable HTTP. Il exécute l’amont @playwright/mcp comme surface canonique des outils navigateur et ajoute autour des fonctions d’exécution CloakBrowser orientées déploiement.
Démo de 30 secondes¶
Regardez le premier lancement : démarrez le paquet npm, connectez un client MCP, demandez une recherche web, une automatisation ou des tests, puis inspectez le résultat dans un vrai navigateur.
Utilisez-le lorsque vous voulez des outils navigateur compatibles Playwright MCP avec profils persistants, chargement d’extensions, validation de contexte, correspondance GeoIP de proxy pour la QA régionale ou saisie humanisée.
Version actuelle : v1.7.0.
Compatibilité entre versions¶
| cloakbrowser-mcp | @playwright/mcp | Playwright MCP Docker base | CloakBrowser | Transport | Parity |
|---|---|---|---|---|---|
1.7.0 | ^0.0.77 | mcr.microsoft.com/playwright/mcp:v0.0.77 | ^0.4.8 | stdio, Streamable HTTP | Comparé dans CI |
1.6.1 | ^0.0.77 | mcr.microsoft.com/playwright/mcp:v0.0.77 | ^0.4.7 | stdio, Streamable HTTP | Comparé dans CI |
1.6.0 | ^0.0.77 | mcr.microsoft.com/playwright/mcp:v0.0.77 | ^0.4.7 | stdio, Streamable HTTP | Comparé dans CI |
1.5.0 | ^0.0.76 | mcr.microsoft.com/playwright/mcp:v0.0.76 | ^0.4.3 | stdio, Streamable HTTP | Comparé dans CI |
1.4.0 | ^0.0.76 | mcr.microsoft.com/playwright/mcp:v0.0.76 | ^0.3.32 | stdio, Streamable HTTP | Comparé dans CI |
1.3.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.31 | stdio, Streamable HTTP | Comparé dans CI |
1.2.7 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparé dans CI |
1.2.6 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparé dans CI |
1.2.5 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparé dans CI |
1.2.3 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparé dans CI |
1.2.2 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparé dans CI |
1.2.1 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparé dans CI |
1.2.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparé dans CI |
1.1.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparé dans CI |
1.0.2 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio | Comparé dans CI |
1.0.1 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio | Comparé dans CI |
1.0.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio | Comparé dans CI |
Consultez la page Compatibilité des versions pour connaître la correspondance mise à jour entre les versions SemVer de ce projet et les versions en amont de Playwright MCP.
De quoi s'agit-il ?¶
- Runtime du pont
Démarre upstream Playwright MCP comme processus enfant et transmet les appels aux outils du navigateur sans modification.
- Exécution de CloakBrowser
Génère une configuration Playwright MCP avec launchOptions.executablePath pointant vers CloakBrowser.
- npm CLI
Publié comme paquet CLI Node.js léger pour les clients MCP stdio et Streamable HTTP.
- Image Docker
Basé sur l'image officielle Playwright MCP et précharge le cache du binaire CloakBrowser.
- Correspondance GeoIP du proxy
Aligne le fuseau horaire, la langue et la locale de l'empreinte CloakBrowser sur l'emplacement du proxy configuré.
- Comportement de saisie humanisé
Fait passer les interactions de page par la couche de souris, clavier et défilement humanisée de CloakBrowser.
Surface de l'outil¶
Les contrats de l'outil Playwright MCP en amont font autorité. Ce projet n'ajoute que deux outils d'introspection locaux :
cloakbrowser_binary_infocloakbrowser_bridge_info
Prochaines étapes¶
- Mise en route pour la configuration de npm, Docker et du client MCP.
- Configuration des variables d'environnement prises en charge.
- Correspondance de proxy GeoIP pour l'assurance qualité régionale, les métadonnées de proxy d'exécution et les sessions HTTP Streamable multi-sites.
- Comportement d'entrée humanisé pour le réalisme des interactions, la configuration et les cas d'utilisation.
- Outils pour les attentes en matière d’interface utilisateur et la parité en amont.
- FAQ pour les questions courantes sur l’installation, Docker, la parité et la sécurité.
- Guide du contributeur pour les détails relatifs au développement, aux tests, à l'architecture et aux versions.
Parcours pratiques supplémentaires¶
Pour choisir entre Playwright MCP amont et ce paquet, consultez la comparaison. Pour des tâches courtes, utilisez les recettes: profil persistant, extensions, reverse proxy, QA régionale, Claude Desktop, Codex CLI et test smoke CI.