@simplysm/mcp-playwright 13.0.71

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {} from "@playwright/mcp";
+import { SessionManager } from "./session-manager.js";
+import { registerProxiedTools } from "./tool-proxy.js";
+const config = {
+  browser: { isolated: true, launchOptions: { headless: true } },
+  outputDir: ".tmp/playwright"
+};
+const server = new Server(
+  { name: "mcp-playwright", version: "1.0.0" },
+  {
+    capabilities: { tools: {} },
+    instructions: "Multi-session Playwright MCP server. Each tool requires a 'sessionId' for browser isolation.\nOutput directory: .tmp/playwright"
+  }
+);
+const sessionManager = new SessionManager(config);
+await registerProxiedTools(server, sessionManager);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+async function shutdown() {
+  await sessionManager.disposeAll();
+  process.exit(0);
+}
+process.on("SIGINT", () => void shutdown());
+process.on("SIGTERM", () => void shutdown());
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "mappings": ";AAEA,SAAS,cAAc;AACvB,SAAS,4BAA4B;AACrC,eAAsC;AACtC,SAAS,sBAAsB;AAC/B,SAAS,4BAA4B;AAErC,MAAM,SAA8D;AAAA,EAClE,SAAS,EAAE,UAAU,MAAM,eAAe,EAAE,UAAU,KAAK,EAAE;AAAA,EAC7D,WAAW;AACb;AAEA,MAAM,SAAS,IAAI;AAAA,EACjB,EAAE,MAAM,kBAAkB,SAAS,QAAQ;AAAA,EAC3C;AAAA,IACE,cAAc,EAAE,OAAO,CAAC,EAAE;AAAA,IAC1B,cAAc;AAAA,EAChB;AACF;AAEA,MAAM,iBAAiB,IAAI,eAAe,MAAM;AAEhD,MAAM,qBAAqB,QAAQ,cAAc;AAEjD,MAAM,YAAY,IAAI,qBAAqB;AAC3C,MAAM,OAAO,QAAQ,SAAS;AAE9B,eAAe,WAA0B;AACvC,QAAM,eAAe,WAAW;AAChC,UAAQ,KAAK,CAAC;AAChB;AAEA,QAAQ,GAAG,UAAU,MAAM,KAAK,SAAS,CAAC;AAC1C,QAAQ,GAAG,WAAW,MAAM,KAAK,SAAS,CAAC;",
+  "names": []
+}

package/dist/session-manager.d.ts

@@ -0,0 +1,16 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+export declare class SessionManager {
+    private readonly config;
+    private readonly timeoutMs;
+    private readonly _sessions;
+    private readonly _pending;
+    private readonly _cleanupInterval;
+    constructor(config: Record<string, unknown>, timeoutMs?: number);
+    getOrCreate(sessionId: string): Promise<Client>;
+    destroy(sessionId: string): Promise<void>;
+    disposeAll(): Promise<void>;
+    list(): string[];
+    private _createSession;
+    private _cleanup;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAQnE,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAChE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiC;gBAG/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,SAAgB;IAOtC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB/C,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,IAAI,IAAI,MAAM,EAAE;YAIF,cAAc;YASd,QAAQ;CAQvB"}

package/dist/session-manager.js

@@ -0,0 +1,68 @@
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { createConnection } from "@playwright/mcp";
+class SessionManager {
+  constructor(config, timeoutMs = 5 * 60 * 1e3) {
+    this.config = config;
+    this.timeoutMs = timeoutMs;
+    this._cleanupInterval = setInterval(() => {
+      void this._cleanup();
+    }, 3e4);
+  }
+  _sessions = /* @__PURE__ */ new Map();
+  _pending = /* @__PURE__ */ new Map();
+  _cleanupInterval;
+  async getOrCreate(sessionId) {
+    let session = this._sessions.get(sessionId);
+    if (session == null) {
+      let pending = this._pending.get(sessionId);
+      if (pending == null) {
+        pending = this._createSession().then((s) => {
+          this._sessions.set(sessionId, s);
+          return s;
+        }).finally(() => {
+          this._pending.delete(sessionId);
+        });
+        this._pending.set(sessionId, pending);
+      }
+      session = await pending;
+    }
+    session.lastUsed = Date.now();
+    return session.client;
+  }
+  async destroy(sessionId) {
+    const session = this._sessions.get(sessionId);
+    if (session != null) {
+      this._sessions.delete(sessionId);
+      await session.client.close();
+    }
+  }
+  async disposeAll() {
+    clearInterval(this._cleanupInterval);
+    const ids = [...this._sessions.keys()];
+    await Promise.all(ids.map((id) => this.destroy(id)));
+  }
+  list() {
+    return [...this._sessions.keys()];
+  }
+  async _createSession() {
+    const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+    const innerServer = await createConnection(this.config);
+    await innerServer.connect(serverTransport);
+    const client = new Client({ name: "mcp-playwright-proxy", version: "1.0.0" });
+    await client.connect(clientTransport);
+    return { client, lastUsed: Date.now() };
+  }
+  async _cleanup() {
+    const now = Date.now();
+    for (const [id, session] of this._sessions) {
+      if (now - session.lastUsed > this.timeoutMs) {
+        await this.destroy(id);
+      }
+    }
+  }
+}
+export {
+  SessionManager
+};
+//# sourceMappingURL=session-manager.js.map

package/dist/session-manager.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/session-manager.ts"],
+  "mappings": "AAAA,SAAS,yBAAyB;AAClC,SAAS,cAAc;AACvB,SAAS,wBAAwB;AAO1B,MAAM,eAAe;AAAA,EAK1B,YACmB,QACA,YAAY,IAAI,KAAK,KACtC;AAFiB;AACA;AAEjB,SAAK,mBAAmB,YAAY,MAAM;AACxC,WAAK,KAAK,SAAS;AAAA,IACrB,GAAG,GAAM;AAAA,EACX;AAAA,EAXiB,YAAY,oBAAI,IAAqB;AAAA,EACrC,WAAW,oBAAI,IAA8B;AAAA,EAC7C;AAAA,EAWjB,MAAM,YAAY,WAAoC;AACpD,QAAI,UAAU,KAAK,UAAU,IAAI,SAAS;AAC1C,QAAI,WAAW,MAAM;AACnB,UAAI,UAAU,KAAK,SAAS,IAAI,SAAS;AACzC,UAAI,WAAW,MAAM;AACnB,kBAAU,KAAK,eAAe,EAAE,KAAK,CAAC,MAAM;AAC1C,eAAK,UAAU,IAAI,WAAW,CAAC;AAC/B,iBAAO;AAAA,QACT,CAAC,EAAE,QAAQ,MAAM;AACf,eAAK,SAAS,OAAO,SAAS;AAAA,QAChC,CAAC;AACD,aAAK,SAAS,IAAI,WAAW,OAAO;AAAA,MACtC;AACA,gBAAU,MAAM;AAAA,IAClB;AACA,YAAQ,WAAW,KAAK,IAAI;AAC5B,WAAO,QAAQ;AAAA,EACjB;AAAA,EAEA,MAAM,QAAQ,WAAkC;AAC9C,UAAM,UAAU,KAAK,UAAU,IAAI,SAAS;AAC5C,QAAI,WAAW,MAAM;AACnB,WAAK,UAAU,OAAO,SAAS;AAC/B,YAAM,QAAQ,OAAO,MAAM;AAAA,IAC7B;AAAA,EACF;AAAA,EAEA,MAAM,aAA4B;AAChC,kBAAc,KAAK,gBAAgB;AACnC,UAAM,MAAM,CAAC,GAAG,KAAK,UAAU,KAAK,CAAC;AACrC,UAAM,QAAQ,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC,CAAC;AAAA,EACrD;AAAA,EAEA,OAAiB;AACf,WAAO,CAAC,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA,EAClC;AAAA,EAEA,MAAc,iBAAmC;AAC/C,UAAM,CAAC,iBAAiB,eAAe,IAAI,kBAAkB,iBAAiB;AAC9E,UAAM,cAAc,MAAM,iBAAiB,KAAK,MAAe;AAC/D,UAAM,YAAY,QAAQ,eAAe;AACzC,UAAM,SAAS,IAAI,OAAO,EAAE,MAAM,wBAAwB,SAAS,QAAQ,CAAC;AAC5E,UAAM,OAAO,QAAQ,eAAe;AACpC,WAAO,EAAE,QAAQ,UAAU,KAAK,IAAI,EAAE;AAAA,EACxC;AAAA,EAEA,MAAc,WAA0B;AACtC,UAAM,MAAM,KAAK,IAAI;AACrB,eAAW,CAAC,IAAI,OAAO,KAAK,KAAK,WAAW;AAC1C,UAAI,MAAM,QAAQ,WAAW,KAAK,WAAW;AAC3C,cAAM,KAAK,QAAQ,EAAE;AAAA,MACvB;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/tool-proxy.d.ts

@@ -0,0 +1,6 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { type Tool } from "@modelcontextprotocol/sdk/types.js";
+import { type SessionManager } from "./session-manager.js";
+export declare function injectSessionId(tool: Tool): Tool;
+export declare function registerProxiedTools(server: Server, sessionManager: SessionManager): Promise<void>;
+//# sourceMappingURL=tool-proxy.d.ts.map

package/dist/tool-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-proxy.d.ts","sourceRoot":"","sources":["../src/tool-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAGL,KAAK,IAAI,EACV,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAahD;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,IAAI,CAAC,CAiEf"}

package/dist/tool-proxy.js

@@ -0,0 +1,84 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import {
+  ListToolsRequestSchema,
+  CallToolRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+import {} from "./session-manager.js";
+function injectSessionId(tool) {
+  const existing = tool.inputSchema.required;
+  return {
+    ...tool,
+    inputSchema: {
+      ...tool.inputSchema,
+      properties: {
+        sessionId: { type: "string", description: "Session ID for browser isolation" },
+        ...tool.inputSchema.properties ?? {}
+      },
+      required: ["sessionId", ...existing?.filter((r) => r !== "sessionId") ?? []]
+    }
+  };
+}
+async function registerProxiedTools(server, sessionManager) {
+  const bootstrapClient = await sessionManager.getOrCreate("__bootstrap__");
+  let playwrightTools;
+  try {
+    ({ tools: playwrightTools } = await bootstrapClient.listTools());
+  } finally {
+    await sessionManager.destroy("__bootstrap__");
+  }
+  const proxiedTools = playwrightTools.map(injectSessionId);
+  const allTools = [
+    ...proxiedTools,
+    {
+      name: "session_close",
+      description: "Close a browser session and release resources",
+      inputSchema: {
+        type: "object",
+        properties: {
+          sessionId: { type: "string", description: "Session ID to close" }
+        },
+        required: ["sessionId"]
+      }
+    },
+    {
+      name: "session_list",
+      description: "List all active browser session IDs",
+      inputSchema: {
+        type: "object",
+        properties: {}
+      }
+    }
+  ];
+  server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: allTools }));
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+    if (name === "session_close") {
+      const { sessionId: sessionId2 } = args;
+      await sessionManager.destroy(sessionId2);
+      return { content: [{ type: "text", text: `Session '${sessionId2}' closed.` }] };
+    }
+    if (name === "session_list") {
+      const sessions = sessionManager.list();
+      return {
+        content: [{ type: "text", text: JSON.stringify(sessions, null, 2) }]
+      };
+    }
+    const sessionId = args["sessionId"];
+    if (typeof sessionId !== "string" || sessionId === "") {
+      throw new Error("Missing required argument: sessionId");
+    }
+    const { sessionId: _, ...toolArgs } = args;
+    const client = await sessionManager.getOrCreate(sessionId);
+    try {
+      return await client.callTool({ name, arguments: toolArgs });
+    } catch (err) {
+      await sessionManager.destroy(sessionId);
+      throw err;
+    }
+  });
+}
+export {
+  injectSessionId,
+  registerProxiedTools
+};
+//# sourceMappingURL=tool-proxy.js.map

package/dist/tool-proxy.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/tool-proxy.ts"],
+  "mappings": "AAAA,SAAS,cAAc;AACvB;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,eAAoC;AAE7B,SAAS,gBAAgB,MAAkB;AAChD,QAAM,WAAW,KAAK,YAAY;AAClC,SAAO;AAAA,IACL,GAAG;AAAA,IACH,aAAa;AAAA,MACX,GAAG,KAAK;AAAA,MACR,YAAY;AAAA,QACV,WAAW,EAAE,MAAM,UAAU,aAAa,mCAAmC;AAAA,QAC7E,GAAI,KAAK,YAAY,cAAc,CAAC;AAAA,MACtC;AAAA,MACA,UAAU,CAAC,aAAa,GAAI,UAAU,OAAO,CAAC,MAAM,MAAM,WAAW,KAAK,CAAC,CAAE;AAAA,IAC/E;AAAA,EACF;AACF;AAEA,eAAsB,qBACpB,QACA,gBACe;AAEf,QAAM,kBAAkB,MAAM,eAAe,YAAY,eAAe;AACxE,MAAI;AACJ,MAAI;AACF,KAAC,EAAE,OAAO,gBAAgB,IAAI,MAAM,gBAAgB,UAAU;AAAA,EAChE,UAAE;AACA,UAAM,eAAe,QAAQ,eAAe;AAAA,EAC9C;AAEA,QAAM,eAAe,gBAAgB,IAAI,eAAe;AACxD,QAAM,WAAmB;AAAA,IACvB,GAAG;AAAA,IACH;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aAAa;AAAA,QACX,MAAM;AAAA,QACN,YAAY;AAAA,UACV,WAAW,EAAE,MAAM,UAAU,aAAa,sBAAsB;AAAA,QAClE;AAAA,QACA,UAAU,CAAC,WAAW;AAAA,MACxB;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aAAa;AAAA,QACX,MAAM;AAAA,QACN,YAAY,CAAC;AAAA,MACf;AAAA,IACF;AAAA,EACF;AAEA,SAAO,kBAAkB,wBAAwB,OAAO,EAAE,OAAO,SAAS,EAAE;AAE5E,SAAO,kBAAkB,uBAAuB,OAAO,YAAY;AACjE,UAAM,EAAE,MAAM,WAAW,OAAO,CAAC,EAAE,IAAI,QAAQ;AAE/C,QAAI,SAAS,iBAAiB;AAC5B,YAAM,EAAE,WAAAA,WAAU,IAAI;AACtB,YAAM,eAAe,QAAQA,UAAS;AACtC,aAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAiB,MAAM,YAAYA,UAAS,YAAY,CAAC,EAAE;AAAA,IACxF;AAEA,QAAI,SAAS,gBAAgB;AAC3B,YAAM,WAAW,eAAe,KAAK;AACrC,aAAO;AAAA,QACL,SAAS,CAAC,EAAE,MAAM,QAAiB,MAAM,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE,CAAC;AAAA,MAC9E;AAAA,IACF;AAEA,UAAM,YAAY,KAAK,WAAW;AAClC,QAAI,OAAO,cAAc,YAAY,cAAc,IAAI;AACrD,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AACA,UAAM,EAAE,WAAW,GAAG,GAAG,SAAS,IAAI;AACtC,UAAM,SAAS,MAAM,eAAe,YAAY,SAAS;AACzD,QAAI;AACF,aAAO,MAAM,OAAO,SAAS,EAAE,MAAM,WAAW,SAAS,CAAC;AAAA,IAC5D,SAAS,KAAK;AACZ,YAAM,eAAe,QAAQ,SAAS;AACtC,YAAM;AAAA,IACR;AAAA,EACF,CAAC;AACH;",
+  "names": ["sessionId"]
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@simplysm/mcp-playwright",
+  "version": "13.0.71",
+  "description": "Simplysm MCP server — multi-session Playwright proxy",
+  "author": "simplysm",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kslhunter/simplysm.git",
+    "directory": "packages/mcp-playwright"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@playwright/mcp": "^0.0.68",
+    "playwright": "^1.58.2"
+  },
+  "bin": {
+    "sd-mcp-playwright": "./dist/index.js"
+  }
+}

package/src/index.ts

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { type createConnection } from "@playwright/mcp";
+import { SessionManager } from "./session-manager.js";
+import { registerProxiedTools } from "./tool-proxy.js";
+
+const config: NonNullable<Parameters<typeof createConnection>[0]> = {
+  browser: { isolated: true, launchOptions: { headless: true } },
+  outputDir: ".tmp/playwright",
+};
+
+const server = new Server(
+  { name: "mcp-playwright", version: "1.0.0" },
+  {
+    capabilities: { tools: {} },
+    instructions: "Multi-session Playwright MCP server. Each tool requires a 'sessionId' for browser isolation.\nOutput directory: .tmp/playwright",
+  },
+);
+
+const sessionManager = new SessionManager(config);
+
+await registerProxiedTools(server, sessionManager);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+
+async function shutdown(): Promise<void> {
+  await sessionManager.disposeAll();
+  process.exit(0);
+}
+
+process.on("SIGINT", () => void shutdown());
+process.on("SIGTERM", () => void shutdown());

package/src/session-manager.ts

@@ -0,0 +1,78 @@
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { createConnection } from "@playwright/mcp";
+
+interface Session {
+  client: Client;
+  lastUsed: number;
+}
+
+export class SessionManager {
+  private readonly _sessions = new Map<string, Session>();
+  private readonly _pending = new Map<string, Promise<Session>>();
+  private readonly _cleanupInterval: ReturnType<typeof setInterval>;
+
+  constructor(
+    private readonly config: Record<string, unknown>,
+    private readonly timeoutMs = 5 * 60 * 1000,
+  ) {
+    this._cleanupInterval = setInterval(() => {
+      void this._cleanup();
+    }, 30_000);
+  }
+
+  async getOrCreate(sessionId: string): Promise<Client> {
+    let session = this._sessions.get(sessionId);
+    if (session == null) {
+      let pending = this._pending.get(sessionId);
+      if (pending == null) {
+        pending = this._createSession().then((s) => {
+          this._sessions.set(sessionId, s);
+          return s;
+        }).finally(() => {
+          this._pending.delete(sessionId);
+        });
+        this._pending.set(sessionId, pending);
+      }
+      session = await pending;
+    }
+    session.lastUsed = Date.now();
+    return session.client;
+  }
+
+  async destroy(sessionId: string): Promise<void> {
+    const session = this._sessions.get(sessionId);
+    if (session != null) {
+      this._sessions.delete(sessionId);
+      await session.client.close();
+    }
+  }
+
+  async disposeAll(): Promise<void> {
+    clearInterval(this._cleanupInterval);
+    const ids = [...this._sessions.keys()];
+    await Promise.all(ids.map((id) => this.destroy(id)));
+  }
+
+  list(): string[] {
+    return [...this._sessions.keys()];
+  }
+
+  private async _createSession(): Promise<Session> {
+    const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+    const innerServer = await createConnection(this.config as never);
+    await innerServer.connect(serverTransport);
+    const client = new Client({ name: "mcp-playwright-proxy", version: "1.0.0" });
+    await client.connect(clientTransport);
+    return { client, lastUsed: Date.now() };
+  }
+
+  private async _cleanup(): Promise<void> {
+    const now = Date.now();
+    for (const [id, session] of this._sessions) {
+      if (now - session.lastUsed > this.timeoutMs) {
+        await this.destroy(id);
+      }
+    }
+  }
+}

package/src/tool-proxy.ts

@@ -0,0 +1,92 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import {
+  ListToolsRequestSchema,
+  CallToolRequestSchema,
+  type Tool,
+} from "@modelcontextprotocol/sdk/types.js";
+import { type SessionManager } from "./session-manager.js";
+
+export function injectSessionId(tool: Tool): Tool {
+  const existing = tool.inputSchema.required as string[] | undefined;
+  return {
+    ...tool,
+    inputSchema: {
+      ...tool.inputSchema,
+      properties: {
+        sessionId: { type: "string", description: "Session ID for browser isolation" },
+        ...(tool.inputSchema.properties ?? {}),
+      },
+      required: ["sessionId", ...(existing?.filter((r) => r !== "sessionId") ?? [])],
+    },
+  };
+}
+
+export async function registerProxiedTools(
+  server: Server,
+  sessionManager: SessionManager,
+): Promise<void> {
+  // Bootstrap: get tool list from @playwright/mcp (no browser launched)
+  const bootstrapClient = await sessionManager.getOrCreate("__bootstrap__");
+  let playwrightTools: Tool[];
+  try {
+    ({ tools: playwrightTools } = await bootstrapClient.listTools());
+  } finally {
+    await sessionManager.destroy("__bootstrap__");
+  }
+
+  const proxiedTools = playwrightTools.map(injectSessionId);
+  const allTools: Tool[] = [
+    ...proxiedTools,
+    {
+      name: "session_close",
+      description: "Close a browser session and release resources",
+      inputSchema: {
+        type: "object",
+        properties: {
+          sessionId: { type: "string", description: "Session ID to close" },
+        },
+        required: ["sessionId"],
+      },
+    },
+    {
+      name: "session_list",
+      description: "List all active browser session IDs",
+      inputSchema: {
+        type: "object",
+        properties: {},
+      },
+    },
+  ];
+
+  server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: allTools }));
+
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+
+    if (name === "session_close") {
+      const { sessionId } = args as { sessionId: string };
+      await sessionManager.destroy(sessionId);
+      return { content: [{ type: "text" as const, text: `Session '${sessionId}' closed.` }] };
+    }
+
+    if (name === "session_list") {
+      const sessions = sessionManager.list();
+      return {
+        content: [{ type: "text" as const, text: JSON.stringify(sessions, null, 2) }],
+      };
+    }
+
+    const sessionId = args["sessionId"];
+    if (typeof sessionId !== "string" || sessionId === "") {
+      throw new Error("Missing required argument: sessionId");
+    }
+    const { sessionId: _, ...toolArgs } = args as { sessionId: string; [key: string]: unknown };
+    const client = await sessionManager.getOrCreate(sessionId);
+    try {
+      return await client.callTool({ name, arguments: toolArgs });
+    } catch (err) {
+      await sessionManager.destroy(sessionId);
+      throw err;
+    }
+  });
+}