@kiro-paradigm/browser 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Frank Ren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,56 @@
+# Browser Power for Kiro
+
+A [Kiro](https://kiro.dev) power providing browser automation with a CDP fallback MCP server.
+
+## What's Included
+
+| Component | Purpose |
+|-----------|---------|
+| `.kiro/powers/browser/` | Kiro power (Playwright + CDP + Chrome DevTools MCP servers) |
+| `src/` | CDP fallback MCP server (`@renfeng/kiro-browser-alternative`) |
+
+## MCP Servers
+
+- **Playwright** (enabled) — Full browser automation via `@playwright/mcp`
+- **alternative** (enabled) — Fallback for when Chrome is already running with the same user data directory
+- **Chrome DevTools** (disabled) — Alternative via `chrome-devtools-mcp`
+
+## Quick Start
+
+### As a Kiro Power
+
+1. Clone this repo
+2. In Kiro, open Command Palette → "Powers" → "Add power from Local Path"
+3. Select the `.kiro/powers/browser` directory
+
+### As a Workspace Root
+
+Add to your `.code-workspace`:
+
+```json
+{ "name": "browser", "path": "../browser-kirospace" }
+```
+
+The power at `.kiro/powers/browser/` is auto-discovered.
+
+## CDP Fallback
+
+When Playwright fails with "Opening in existing browser session", the `alternative` server auto-discovers the running Chrome's CDP port and connects directly. Tools:
+
+- `cdp_list_tabs` — List open tabs
+- `cdp_navigate` — Navigate a tab to a URL
+- `cdp_screenshot` — Capture viewport as PNG
+- `cdp_evaluate` — Run JavaScript in a tab
+- `cdp_reload` — Reload a tab
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT

package/dist/cdp-client.d.ts

@@ -0,0 +1,57 @@
+/**
+ * CDP Client — low-level Chrome DevTools Protocol communication.
+ *
+ * Discovers the CDP port from running Chrome processes, lists tabs,
+ * and sends CDP commands over websockets.
+ */
+interface CdpTab {
+    id: string;
+    type: string;
+    title?: string;
+    url?: string;
+    webSocketDebuggerUrl?: string;
+}
+interface CdpResponse {
+    id?: number;
+    result?: Record<string, unknown>;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+export interface CdpEvalResult {
+    type?: string;
+    subtype?: string;
+    value?: unknown;
+    description?: string;
+}
+export declare class CdpClient {
+    private cachedPort;
+    private readonly cwd;
+    constructor(cwd?: string);
+    /**
+     * Auto-discover the CDP port from running Chrome processes.
+     *
+     * Convention: looks for a Chrome process whose --user-data-dir ends with
+     * `.playwright-data` and matches the working directory of this process.
+     * This ensures the CDP fallback connects to the same Chrome instance that
+     * Playwright launched for the current workspace.
+     *
+     * Falls back to the first discovered port if no workspace match is found.
+     */
+    discoverPort(): Promise<number>;
+    /**
+     * List open tabs on the given CDP port.
+     */
+    listTabs(port: number): Promise<CdpTab[]>;
+    /**
+     * Get the websocket URL for a tab by index.
+     */
+    getTabWsUrl(port: number, tabIndex: number): Promise<string>;
+    /**
+     * Send a CDP command and return the response.
+     */
+    send(wsUrl: string, method: string, params?: Record<string, unknown>, timeout?: number): Promise<CdpResponse>;
+    private httpGet;
+}
+export {};

package/dist/cdp-client.js

@@ -0,0 +1,150 @@
+/**
+ * CDP Client — low-level Chrome DevTools Protocol communication.
+ *
+ * Discovers the CDP port from running Chrome processes, lists tabs,
+ * and sends CDP commands over websockets.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import http from 'node:http';
+import WebSocket from 'ws';
+const execFileAsync = promisify(execFile);
+export class CdpClient {
+    cachedPort = null;
+    cwd;
+    constructor(cwd) {
+        this.cwd = cwd ?? process.cwd();
+    }
+    /**
+     * Auto-discover the CDP port from running Chrome processes.
+     *
+     * Convention: looks for a Chrome process whose --user-data-dir ends with
+     * `.playwright-data` and matches the working directory of this process.
+     * This ensures the CDP fallback connects to the same Chrome instance that
+     * Playwright launched for the current workspace.
+     *
+     * Falls back to the first discovered port if no workspace match is found.
+     */
+    async discoverPort() {
+        if (this.cachedPort) {
+            try {
+                await this.httpGet(`http://localhost:${this.cachedPort}/json/version`);
+                return this.cachedPort;
+            }
+            catch {
+                this.cachedPort = null;
+            }
+        }
+        try {
+            // Convention: match the .playwright-data dir under the current working directory
+            const expectedDataDir = `${this.cwd}/.playwright-data`;
+            // Try workspace-specific match first (own try/catch so failure falls through to generic)
+            try {
+                // Run ps aux and match in Node.js to avoid shell escaping and prefix-collision issues.
+                // grep -F with env var narrows to candidate lines; JS does exact boundary matching.
+                const { stdout: specificOut } = await execFileAsync('bash', [
+                    '-c',
+                    `ps aux | grep -v grep | grep -F "user-data-dir=$EXPECTED_DIR"`,
+                ], { env: { ...process.env, EXPECTED_DIR: expectedDataDir } });
+                // Exact boundary match: the path must be followed by a space, quote, or end-of-line
+                const portPattern = /remote-debugging-port=(\d+)/;
+                const exactPattern = `user-data-dir=${expectedDataDir}`;
+                const matchedLine = specificOut.split('\n').find(line => {
+                    const idx = line.indexOf(exactPattern);
+                    if (idx === -1)
+                        return false;
+                    const afterChar = line[idx + exactPattern.length];
+                    return afterChar === undefined || afterChar === ' ' || afterChar === '"' || afterChar === "'" || afterChar === '/';
+                });
+                const specificMatch = matchedLine?.match(portPattern);
+                if (specificMatch) {
+                    const port = parseInt(specificMatch[1], 10);
+                    await this.httpGet(`http://localhost:${port}/json/version`);
+                    this.cachedPort = port;
+                    return port;
+                }
+            }
+            catch {
+                // Workspace-specific discovery failed — fall through to generic.
+                // Intentionally silent: the generic path will either succeed or the
+                // outer catch will surface a meaningful error message.
+            }
+            // Fall back to any Chrome with remote-debugging-port
+            const { stdout } = await execFileAsync('bash', [
+                '-c',
+                'ps aux | grep -v grep | grep -o "remote-debugging-port=[0-9]*" | head -1',
+            ]);
+            const match = stdout.trim().match(/remote-debugging-port=(\d+)/);
+            if (match) {
+                const port = parseInt(match[1], 10);
+                await this.httpGet(`http://localhost:${port}/json/version`);
+                this.cachedPort = port;
+                return port;
+            }
+        }
+        catch {
+            // fall through
+        }
+        throw new Error('Cannot find a running Chrome with --remote-debugging-port. ' +
+            'Start Chrome with --remote-debugging-port=PORT or let Playwright MCP launch it first.');
+    }
+    /**
+     * List open tabs on the given CDP port.
+     */
+    async listTabs(port) {
+        const body = await this.httpGet(`http://localhost:${port}/json/list`);
+        return JSON.parse(body);
+    }
+    /**
+     * Get the websocket URL for a tab by index.
+     */
+    async getTabWsUrl(port, tabIndex) {
+        const tabs = await this.listTabs(port);
+        if (tabIndex < 0 || tabIndex >= tabs.length) {
+            throw new Error(`Tab index ${tabIndex} out of range (0-${tabs.length - 1})`);
+        }
+        const wsUrl = tabs[tabIndex].webSocketDebuggerUrl;
+        if (!wsUrl) {
+            throw new Error(`Tab ${tabIndex} has no webSocketDebuggerUrl (type: ${tabs[tabIndex].type})`);
+        }
+        return wsUrl;
+    }
+    /**
+     * Send a CDP command and return the response.
+     */
+    async send(wsUrl, method, params = {}, timeout = 30000) {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(wsUrl, { maxPayload: 50 * 1024 * 1024 });
+            const timer = setTimeout(() => {
+                ws.close();
+                reject(new Error(`Timeout waiting for CDP response to ${method}`));
+            }, timeout);
+            ws.on('open', () => {
+                ws.send(JSON.stringify({ id: 1, method, params }));
+            });
+            ws.on('message', (data) => {
+                const msg = JSON.parse(data.toString());
+                if (msg.id === 1) {
+                    clearTimeout(timer);
+                    ws.close();
+                    resolve(msg);
+                }
+            });
+            ws.on('error', (err) => {
+                clearTimeout(timer);
+                reject(err);
+            });
+        });
+    }
+    httpGet(url) {
+        return new Promise((resolve, reject) => {
+            http.get(url, { timeout: 5000 }, (res) => {
+                let body = '';
+                res.on('data', (chunk) => { body += chunk.toString(); });
+                res.on('end', () => resolve(body));
+                res.on('error', reject);
+            }).on('error', reject);
+        });
+    }
+}
+//# sourceMappingURL=cdp-client.js.map

package/dist/cdp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-client.js","sourceRoot":"","sources":["../src/cdp-client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * CDP Browser MCP Server — connects to an already-running Chrome instance
+ * via Chrome DevTools Protocol when Playwright MCP cannot launch.
+ *
+ * Auto-discovers the CDP port from running Chrome processes.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+/**
+ * CDP Browser MCP Server — connects to an already-running Chrome instance
+ * via Chrome DevTools Protocol when Playwright MCP cannot launch.
+ *
+ * Auto-discovers the CDP port from running Chrome processes.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { CdpClient } from './cdp-client.js';
+const server = new McpServer({
+    name: 'alternative',
+    version: '0.1.0',
+});
+// Workspace-specific port discovery relies on process.cwd() being the workspace
+// folder at startup. Kiro sets cwd to the workspace folder when launching MCP
+// servers, so the default (no explicit cwd) is correct for production use.
+const cdp = new CdpClient();
+// --- Tool: cdp_list_tabs ---
+server.tool('cdp_list_tabs', 'List open browser tabs. Auto-discovers the CDP port from running Chrome processes.', { port: z.number().optional().describe('CDP port (auto-detected if omitted)') }, async ({ port }) => {
+    const resolvedPort = port ?? await cdp.discoverPort();
+    const tabs = await cdp.listTabs(resolvedPort);
+    const pages = tabs
+        .filter((t) => t.type === 'page')
+        .map((t, i) => `${i}: ${t.title ?? '(no title)'}\n   ${t.url ?? ''}`);
+    return { content: [{ type: 'text', text: pages.join('\n\n') || '(no page tabs open)' }] };
+});
+// --- Tool: cdp_navigate ---
+server.tool('cdp_navigate', 'Navigate a browser tab to a URL.', {
+    tab: z.number().describe('Tab index from cdp_list_tabs'),
+    url: z.string().describe('URL to navigate to'),
+    wait: z.number().optional().default(3).describe('Seconds to wait after navigation (default: 3)'),
+    port: z.number().optional().describe('CDP port (auto-detected if omitted)'),
+}, async ({ tab, url, wait, port }) => {
+    const resolvedPort = port ?? await cdp.discoverPort();
+    const wsUrl = await cdp.getTabWsUrl(resolvedPort, tab);
+    const result = await cdp.send(wsUrl, 'Page.navigate', { url });
+    if (result.error) {
+        return { content: [{ type: 'text', text: `Error: ${JSON.stringify(result.error)}` }], isError: true };
+    }
+    if (wait > 0)
+        await sleep(wait * 1000);
+    return { content: [{ type: 'text', text: `Navigated to ${url}` }] };
+});
+// --- Tool: cdp_screenshot ---
+server.tool('cdp_screenshot', 'Take a screenshot of a browser tab. Returns the image as base64-encoded PNG.', {
+    tab: z.number().describe('Tab index from cdp_list_tabs'),
+    wait: z.number().optional().default(0).describe('Seconds to wait before screenshot (default: 0)'),
+    port: z.number().optional().describe('CDP port (auto-detected if omitted)'),
+}, async ({ tab, wait, port }) => {
+    const resolvedPort = port ?? await cdp.discoverPort();
+    const wsUrl = await cdp.getTabWsUrl(resolvedPort, tab);
+    if (wait > 0)
+        await sleep(wait * 1000);
+    const result = await cdp.send(wsUrl, 'Page.captureScreenshot', { format: 'png' });
+    if (result.error) {
+        return { content: [{ type: 'text', text: `Error: ${JSON.stringify(result.error)}` }], isError: true };
+    }
+    const data = result.result?.data;
+    if (typeof data !== 'string') {
+        return { content: [{ type: 'text', text: 'Error: no screenshot data returned' }], isError: true };
+    }
+    return {
+        content: [{
+                type: 'image',
+                data,
+                mimeType: 'image/png',
+            }],
+    };
+});
+// --- Tool: cdp_evaluate ---
+server.tool('cdp_evaluate', 'Evaluate a JavaScript expression in a browser tab and return the result.', {
+    tab: z.number().describe('Tab index from cdp_list_tabs'),
+    expression: z.string().describe('JavaScript expression to evaluate'),
+    port: z.number().optional().describe('CDP port (auto-detected if omitted)'),
+}, async ({ tab, expression, port }) => {
+    const resolvedPort = port ?? await cdp.discoverPort();
+    const wsUrl = await cdp.getTabWsUrl(resolvedPort, tab);
+    const result = await cdp.send(wsUrl, 'Runtime.evaluate', {
+        expression,
+        returnByValue: true,
+    });
+    if (result.error) {
+        return { content: [{ type: 'text', text: `Error: ${JSON.stringify(result.error)}` }], isError: true };
+    }
+    const evalResult = result.result?.result;
+    if (!evalResult) {
+        return { content: [{ type: 'text', text: '(no result)' }] };
+    }
+    if (evalResult.type === 'undefined') {
+        return { content: [{ type: 'text', text: '(undefined)' }] };
+    }
+    if (evalResult.subtype === 'error') {
+        return { content: [{ type: 'text', text: `Error: ${evalResult.description ?? evalResult.value}` }], isError: true };
+    }
+    const value = evalResult.value;
+    const text = typeof value === 'string' ? value : JSON.stringify(value, null, 2);
+    return { content: [{ type: 'text', text }] };
+});
+// --- Tool: cdp_reload ---
+server.tool('cdp_reload', 'Reload a browser tab.', {
+    tab: z.number().describe('Tab index from cdp_list_tabs'),
+    wait: z.number().optional().default(3).describe('Seconds to wait after reload (default: 3)'),
+    port: z.number().optional().describe('CDP port (auto-detected if omitted)'),
+}, async ({ tab, wait, port }) => {
+    const resolvedPort = port ?? await cdp.discoverPort();
+    const wsUrl = await cdp.getTabWsUrl(resolvedPort, tab);
+    await cdp.send(wsUrl, 'Page.reload', {});
+    if (wait > 0)
+        await sleep(wait * 1000);
+    return { content: [{ type: 'text', text: 'Page reloaded' }] };
+});
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+// --- Start ---
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error('Fatal:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@kiro-paradigm/browser",
+  "version": "0.1.0",
+  "description": "MCP server providing Chrome DevTools Protocol (CDP) browser automation — connects to an already-running Chrome instance when Playwright MCP cannot launch",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "browser-cdp-mcp": "dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "browser",
+    "chrome",
+    "cdp",
+    "devtools",
+    "automation",
+    "kiro"
+  ],
+  "author": "Frank Ren",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/kiro-paradigm/browser-kirospace.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "type-check": "tsc --noEmit",
+    "test": "vitest --run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.0"
+  }
+}