Skip to content

Latest commit

 

History

History
60 lines (41 loc) · 2.04 KB

File metadata and controls

60 lines (41 loc) · 2.04 KB

SA2WEB MCP

Langues : English | 中文 | 日本語 | Français | Español | Русский

Ce projet expose le navigateur distant SA2 basé sur le DOM sous forme d'outils MCP, utilisables par Claude Code, Cursor, Windsurf, opencode, Hermes Agent, OpenClaw, etc.

Le site cible est rendu dans iframe#rbi-frame. Les outils browser_snapshot, browser_extract_text, browser_click, browser_type et browser_wait utilisent cet iframe en priorité.

Flux recommandé

sa2_help
  -> sa2_list_available_targets
  -> sa2_open_target
  -> browser_snapshot ou browser_extract_text
  -> browser_click / browser_type / browser_press / browser_wait

Pour ouvrir une URL publique :

{
  "type": "cloud",
  "url": "https://example.com"
}

Pour SaaS, espaces de travail ou sites internes, appelez d'abord sa2_list_available_targets, puis transmettez le targetId à sa2_open_target.

Installation

Une fois le paquet publié sur npm, les utilisateurs peuvent l'installer globalement afin que sa2, sa2-browser et sa2-mcp soient disponibles dans le PATH :

npm install -g @sa2web/mcp
npx playwright install chromium --with-deps

Si vous installez depuis un checkout local, construisez d'abord puis installez le dossier courant globalement :

npm install
npx playwright install chromium --with-deps
npm run build
npm install -g .

Un simple npm install installe seulement les dépendances du checkout courant ; il n'ajoute pas les commandes de ce paquet au PATH global. Pour le développement, npm link convient aussi après npm run build.

Configuration

Voir les modèles MCP par plateforme : configs/README.fr.md.

L'origin du navigateur distant est déduit de SA2_LOGIN_URL. SA2_REMOTE_BROWSER_PREFIX et SA2_REMOTE_BROWSER_BASE_URL ne sont pas nécessaires.

Mise à jour des modèles

node scripts/update-configs.mjs -login-url "https://www.test7878.com/agent/login?clientId=xxx&clientSecret=yyy"