टूल¶

cloakbrowser-mcp upstream Playwright MCP tools को बिना बदले expose करता है। Tool names, descriptions, schemas, annotations और responses @playwright/mcp से आते हैं।

Upstream tools¶

Default upstream browser tool surface को pinned Playwright MCP dependency से मेल खाना चाहिए। इसमें navigation, snapshot, click, typing, screenshots, tabs, console messages, network inspection, file upload, dialogs और unsafe evaluation tools जैसे core browser tools शामिल हैं।

स्थिर upstream reference के लिए exact package commit पर pinned Playwright MCP @playwright/mcp@0.0.82 capability test देखें: default and capability-gated tool names।

यह project upstream Playwright MCP को authoritative मानता है और copied schema reference maintain नहीं करता।

डिफ़ॉल्ट सेट में browser_emulate_media सहित 25 upstream tools हैं। PLAYWRIGHT_MCP_CAPS=devtools bridge-विशिष्ट --caps विकल्प के बिना devtools क्षमता को child process तक पहुंचाता है; परिणामस्वरूप upstream tools और schemas बिना बदलाव के आगे भेजे जाते हैं, जिनमें browser_start_recording और browser_stop_recording शामिल हैं।

डायनामिक WebMCP tools¶

Chromium में WebMCP संस्करण 154 से उपलब्ध है। पुराने CloakBrowser build feature flag को अनदेखा करते हैं; WebMCP आवश्यक होने पर compatible browser build या PLAYWRIGHT_MCP_BROWSER_ENGINE=playwright का उपयोग करें।

Chromium को --enable-features=WebMCP के साथ शुरू करने पर पेज webmcp_* tools घोषित कर सकते हैं। ब्रिज notifications/tools/list_changed को आगे भेजता है, पूरा tools/list cache साफ करता है और client को सूची फिर से माँगनी चाहिए। Streamable HTTP में केवल संबंधित session का खुला notification stream घटना प्राप्त करता है; stream न होने पर भी अगला tools/list नया रहता है। नाम, description, schema, annotations और output को अविश्वसनीय page data मानें। ब्रिज WebMCP को अपने आप चालू नहीं करता; PLAYWRIGHT_MCP_WEBMCP=false collection बंद करता है।

स्थानीय tools¶

cloakbrowser_binary_info¶

CloakBrowser package, current platform, cache directory, expected binary path, install status और bridge द्वारा उपयोग किए गए resolved executable path की structured जानकारी लौटाता है।

cloakbrowser_bridge_info¶

Structured bridge metadata लौटाता है:

एडीटिव structuredContent.cdp ऑब्जेक्ट कॉलिंग सेशन के प्रबंधित CDP की रिपोर्ट करता है राज्य:

{ "enabled": false }

{
  "enabled": true,
  "state": "ready",
  "generation": 1,
  "bindHost": "127.0.0.1",
  "port": 9222,
  "advertisedHost": null,
  "discoveryUrl": "http://127.0.0.1:9222/cdp/<capability>",
  "activeConnections": 0
}

{
  "enabled": true,
  "state": "unavailable",
  "generation": 1,
  "bindHost": "127.0.0.1",
  "port": 9222,
  "advertisedHost": null,
  "discoveryUrl": null,
  "activeConnections": 0
}

generation बढ़ता है और ब्राउज़र बदलने के बाद discoveryUrl घूमता है। activeConnections एक्सेप्ट किए गए प्रॉक्सी किए गए WebSocket कनेक्शनों की गिनती करता है बिना एक्सपोज़ किए क्लाइंट पहचान, लक्षित आईडी, या प्रोटोकॉल सामग्री। हर गैर-शून्य खोज URL से निपटें एक प्रमाणपत्र के रूप में।

CDP-सक्षम क्लाइंट के साथ URL खोज का उपयोग करें:

import { chromium } from 'playwright';

const browser = await chromium.connectOverCDP(discoveryUrl);

मैनेज्ड CDP Playwright सर्वर प्रोटोकॉल नहीं है। Playwright chromium.connect() और वर्तमान Open WebUI PLAYWRIGHT_WS_URL एकीकरण अपेक्षा एक Playwright सर्वर एंडपॉइंट और इस URL के साथ संगत नहीं हैं।

• MCP server name और version;
• runtime mode;
• upstream Playwright MCP package और version;
• upstream tool count;
• local Cloak-specific tool names.

स्थानीय tool surface इन्हीं दो निदान tools तक सीमित रहता है। SessionSeats और getSessionSeats MCP tool के रूप में उपलब्ध नहीं हैं, क्योंकि CloakBrowser 0.5.10 इस API को अपने public entry point से export नहीं करता है।

Parity¶

CI Docker इमेज build करता है और npm run bridge:compare चलाता है। यह script official Playwright MCP image और CloakBrowser bridge image को parallel शुरू करता है, upstream tool list की तुलना करता है और same fixture page पर default upstream browser tools चलाता है।

Machine-readable JSON parity report लिखने के लिए --report उपयोग करें:

npm run bridge:compare -- cloakbrowser-mcp:dev --report bridge-parity-report.json

CI इस report को Docker builds और release builds के लिए artifact के रूप में upload करता है।