botbrowser-mcp 0.1.5 → 0.1.7

package/dist/tools/playwright-mcp-proxy.js

@@ -0,0 +1,229 @@
+import { createRequire } from 'node:module';
+// Create a require function for loading CommonJS modules in ES modules
+const require = createRequire(import.meta.url);
+/**
+ * Dynamic Browser Context Factory
+ *
+ * Ensures Playwright MCP always gets the current active context,
+ * not a cached one from initialization time.
+ */
+class DynamicBrowserContextFactory {
+    name = 'dynamic-multi-instance';
+    description = 'Dynamically provides the current active browser context for multi-instance support';
+    contextGetter;
+    constructor(contextGetter) {
+        this.contextGetter = contextGetter;
+    }
+    /**
+     * Called by Playwright MCP Context class every time it needs a browser context
+     * This is invoked via _ensureBrowserContext() which happens on every tool call
+     */
+    async createContext() {
+        // Get the CURRENT active context
+        const browserContext = await this.contextGetter();
+        return {
+            browserContext,
+            // Don't close - lifecycle managed externally by PlaywrightManager
+            close: async () => {
+                // No-op: we manage context lifecycle in our manager
+            }
+        };
+    }
+}
+export class PlaywrightMCPProxy {
+    mcpServer = null;
+    backend = null; // BrowserServerBackend instance
+    contextGetter;
+    factory;
+    tools = new Map();
+    constructor(contextGetter) {
+        this.contextGetter = contextGetter;
+        this.factory = new DynamicBrowserContextFactory(contextGetter);
+    }
+    /**
+     * Initialize the MCP connection with our dynamic context factory
+     *
+     * We directly use Playwright MCP's internal modules to inject our
+     * custom factory, bypassing the createConnection() helper which
+     * doesn't support dynamic context switching.
+     */
+    async initialize() {
+        try {
+            // Use file paths to load internal modules (bypassing package exports restrictions)
+            const playwrightMcpPath = require.resolve('@playwright/mcp');
+            const playwrightMcpDir = playwrightMcpPath.substring(0, playwrightMcpPath.lastIndexOf('/'));
+            const { BrowserServerBackend } = require(`${playwrightMcpDir}/node_modules/playwright/lib/mcp/browser/browserServerBackend`);
+            const mcpServer = require(`${playwrightMcpDir}/node_modules/playwright/lib/mcp/sdk/server`);
+            const packageJSON = require(`${playwrightMcpDir}/package.json`);
+            // Create backend with our dynamic factory
+            // Provide a minimal config matching Playwright MCP's defaultConfig structure
+            const config = {
+                browser: {
+                    browserName: 'chromium',
+                    launchOptions: {
+                        channel: 'chrome',
+                        headless: false,
+                        chromiumSandbox: true
+                    },
+                    contextOptions: {
+                        viewport: null
+                    }
+                },
+                console: {
+                    level: 'info'
+                },
+                network: {
+                    allowedOrigins: undefined,
+                    blockedOrigins: undefined
+                },
+                server: {},
+                saveTrace: false,
+                snapshot: {
+                    mode: 'incremental'
+                },
+                timeouts: {
+                    action: 5000,
+                    navigation: 60000
+                }
+            };
+            this.backend = new BrowserServerBackend(config, this.factory);
+            // Create the MCP server
+            this.mcpServer = mcpServer.createServer('Playwright', packageJSON.version, this.backend, false);
+            // Load all available tools
+            await this.loadTools();
+            console.error('[PlaywrightMCPProxy] Initialized with dynamic multi-instance support');
+        }
+        catch (error) {
+            console.error('[PlaywrightMCPProxy] Initialization failed:', error);
+            throw error;
+        }
+    }
+    /**
+     * Load all tool definitions from Playwright MCP
+     */
+    async loadTools() {
+        if (!this.mcpServer) {
+            throw new Error('MCP Server not initialized');
+        }
+        try {
+            // Get the tools/list handler from the MCP server
+            const handler = this.mcpServer['_requestHandlers'].get('tools/list');
+            if (!handler) {
+                throw new Error('tools/list handler not found in MCP server');
+            }
+            // Call the handler to get all tools
+            const result = await handler({
+                method: 'tools/list',
+                params: {}
+            }, {});
+            // Store tools in our map
+            if (result && result.tools) {
+                for (const tool of result.tools) {
+                    this.tools.set(tool.name, tool);
+                }
+            }
+        }
+        catch (error) {
+            console.error('Failed to load Playwright tools:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get all tool definitions for MCP protocol
+     */
+    getToolDefinitions() {
+        const handlers = {};
+        for (const [name, tool] of this.tools) {
+            handlers[name] = {
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+                handler: async (args) => {
+                    return await this.callTool(name, args);
+                }
+            };
+        }
+        return handlers;
+    }
+    /**
+     * Call a Playwright MCP tool
+     *
+     * Each call will use the CURRENT active browser context thanks to our
+     * dynamic factory, enabling proper multi-instance support.
+     */
+    async callTool(name, args) {
+        if (!this.mcpServer) {
+            throw new Error('MCP Server not initialized');
+        }
+        if (!this.tools.has(name)) {
+            throw new Error(`Unknown Playwright tool: ${name}`);
+        }
+        try {
+            // Get the tools/call handler
+            const handler = this.mcpServer['_requestHandlers'].get('tools/call');
+            if (!handler) {
+                throw new Error('tools/call handler not found in MCP server');
+            }
+            // Call the tool with our arguments
+            const result = await handler({
+                method: 'tools/call',
+                params: {
+                    name,
+                    arguments: args || {}
+                }
+            }, {});
+            return result;
+        }
+        catch (error) {
+            console.error(`Playwright tool '${name}' failed:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Check if a tool exists
+     */
+    hasTool(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * Get list of all tool names
+     */
+    getToolNames() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * Reset the browser context cache
+     *
+     * This forces Playwright MCP's Context to clear its cached BrowserContext,
+     * so the next tool call will fetch the current active context from our factory.
+     *
+     * CRITICAL for multi-instance switching to work correctly.
+     */
+    async resetContext() {
+        if (!this.backend || !this.backend._context) {
+            return;
+        }
+        try {
+            // Directly clear the cached promise without closing pages
+            // This is safer than calling closeBrowserContext() which closes pages
+            this.backend._context._browserContextPromise = undefined;
+            this.backend._context._tabs = [];
+            this.backend._context._currentTab = undefined;
+        }
+        catch (error) {
+            // Silently handle errors during context reset
+        }
+    }
+    /**
+     * Close/cleanup the proxy
+     */
+    async close() {
+        // Clean up if needed
+        if (this.backend && this.backend._context) {
+            await this.backend._context.dispose();
+        }
+        this.mcpServer = null;
+        this.backend = null;
+        this.tools.clear();
+    }
+}
+//# sourceMappingURL=playwright-mcp-proxy.js.map

package/dist/tools/playwright-mcp-proxy.js.map

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

package/dist/tools/profile.js

@@ -27,15 +27,15 @@ export const profileTools = {
             properties: {
                 alias: { type: 'string', description: '配置别名（唯一标识）' },
                 executable_path: { type: 'string', description: 'Chrome 可执行文件路径' },
-                fingerprint_path: { type: 'string', description: '防指纹配置文件路径' },
-                storage_state_path: { type: 'string', description: 'Cookie/LocalStorage 存储路径' },
+                fingerprint_path: { type: 'string', description: '防指纹配置文件路径（可选）' },
+                storage_state_path: { type: 'string', description: 'Cookie/LocalStorage 存储路径（可选，不指定则不保存状态）' },
                 description: { type: 'string', description: '配置描述' },
                 proxy_server: { type: 'string', description: '代理服务器地址' },
                 proxy_username: { type: 'string', description: '代理用户名' },
                 proxy_password: { type: 'string', description: '代理密码' },
                 proxy_bypass: { type: 'string', description: '代理绕过列表' },
             },
-            required: ['alias', 'executable_path', 'fingerprint_path', 'storage_state_path'],
+            required: ['alias', 'executable_path'],
         },
         handler: async (args) => {
             profileRepo.create(args);

package/dist/tools/profile.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botbrowser-mcp",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Multi-instance browser automation MCP server with profile and account management",
   "author": "tonwe",
   "license": "Apache-2.0",
@@ -35,13 +35,13 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
-    "playwright": "^1.49.0",
-    "better-sqlite3": "^11.0.0"
+    "@playwright/mcp": "^0.0.53",
+    "better-sqlite3": "^11.0.0",
+    "playwright": "^1.49.0"
   },
   "devDependencies": {
-    "@types/node": "^22.10.2",
     "@types/better-sqlite3": "^7.6.11",
+    "@types/node": "^22.10.2",
     "typescript": "^5.7.2"
   }
 }
-

package/readme.md

@@ -1,16 +1,18 @@
-# botbrowser-mcp
+# BotBrowser MCP
 
-A wrapper around [@playwright/mcp](https://www.npmjs.com/package/@playwright/mcp).
+多实例浏览器自动化 MCP Server，集成 [@playwright/mcp](https://www.npmjs.com/package/@playwright/mcp) 的 22 个浏览器工具，支持配置管理、账号管理和多实例切换。
 
-## Installation
+**版本:** v0.1.6
+
+## 安装
 
 ```bash
 npm install -g botbrowser-mcp
 ```
 
-## Usage
+## 配置
 
-Add to your MCP client configuration (e.g., Claude Desktop config):
+在 MCP 客户端（如 Claude Desktop）的配置文件中添加：
 
 ```json
 {
@@ -22,7 +24,7 @@ Add to your MCP client configuration (e.g., Claude Desktop config):
 }
 ```
 
-Or use with npx (no installation needed):
+或使用 npx（无需安装）：
 
 ```json
 {
@@ -35,14 +37,226 @@ Or use with npx (no installation needed):
 }
 ```
 
-## Troubleshooting
+## 核心概念
+
+### 三层数据模型
+
+1. **浏览器配置 (Profile)** - 定义浏览器启动参数
+   - Chrome 可执行文件路径
+   - Cookie/LocalStorage 存储路径
+   - 代理设置
+
+2. **账号 (Account)** - 绑定到配置的用户账号
+   - 平台标识（twitter, github 等）
+   - 用户名和元数据（密码、2FA 等）
+
+3. **浏览器实例 (Instance)** - 运行中的浏览器
+   - 基于某个配置启动
+   - 可选关联某个账号
+   - 同时只有一个实例为活跃状态
+
+## 快速开始
+
+### 示例：管理多个 Twitter 账号
+
+```
+# 1. 创建浏览器配置
+create_browser_profile(
+  alias: "twitter-bot",
+  executable_path: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+  storage_state_path: "/Users/me/.botbrowser/twitter_cookies.json"
+)
+
+# 2. 添加账号
+add_account(
+  profile_alias: "twitter-bot",
+  platform: "twitter",
+  identifier: "account1",
+  username: "account1@twitter.com",
+  metadata: "password: SecurePass123"
+)
+
+# 3. 启动浏览器（自动成为活跃实例）
+launch_browser(profile_alias: "twitter-bot", account_id: 1)
+
+# 4. 使用浏览器工具（自动作用于活跃实例）
+browser_navigate(url: "https://twitter.com")
+browser_click(element: "登录按钮")
+
+# 5. 启动第二个实例
+launch_browser(profile_alias: "twitter-bot", account_id: 2)
+
+# 6. 切换回第一个实例
+switch_browser_instance(instance_id: 1)
+```
+
+## 可用工具 (36个)
+
+### 配置管理 (4个)
+- `list_browser_profiles` - 列出所有配置
+- `create_browser_profile` - 创建新配置
+- `update_browser_profile` - 更新配置
+- `delete_browser_profile` - 删除配置
+
+### 账号管理 (5个)
+- `add_account` - 添加账号
+- `list_accounts` - 列出账号
+- `find_account` - 查找账号
+- `update_account` - 更新账号
+- `delete_account` - 删除账号
+
+### 实例管理 (5个)
+- `launch_browser` - 启动浏览器
+- `list_browser_instances` - 列出实例
+- `switch_browser_instance` - 切换活跃实例
+- `stop_browser_instance` - 停止实例
+- `cleanup_orphaned_instances` - 清理孤立记录
+
+### 浏览器操作 (22个 - 来自 @playwright/mcp)
+- `browser_navigate` - 导航到 URL
+- `browser_click` - 点击元素
+- `browser_type` - 输入文本
+- `browser_screenshot` - 截图
+- `browser_evaluate` - 执行 JavaScript
+- `browser_fill_form` - 批量填充表单
+- `browser_select_option` - 选择下拉选项
+- `browser_hover` - 鼠标悬停
+- `browser_drag` - 拖拽操作
+- `browser_handle_dialog` - 处理对话框
+- `browser_file_upload` - 文件上传
+- `browser_navigate_back` - 后退
+- `browser_tabs` - 标签页管理
+- `browser_wait_for` - 等待元素/文本/时间
+- `browser_console_messages` - 获取控制台消息
+- `browser_network_requests` - 获取网络请求
+- `browser_run_code` - 执行 Playwright 代码片段
+- `browser_close` - 关闭页面
+- 其他高级操作工具...
+
+## 架构
+
+```
+┌─────────────────────────────────────────┐
+│      LLM Agent (Claude/Cursor)          │
+│  "启动 twitter-bot 的 account1"          │
+└────────────────┬────────────────────────┘
+                 │ stdio (MCP Protocol)
+                 ↓
+┌─────────────────────────────────────────┐
+│       BotBrowser-MCP Server             │
+│                                         │
+│  ┌─────────────────────────────────┐   │
+│  │   自定义工具 (14个)              │   │
+│  │   - 配置管理 (4)                 │   │
+│  │   - 账号管理 (5)                 │   │
+│  │   - 实例管理 (5)                 │   │
+│  └─────────────────────────────────┘   │
+│                                         │
+│  ┌─────────────────────────────────┐   │
+│  │   PlaywrightMCPProxy            │   │
+│  │   - 包装 @playwright/mcp        │   │
+│  │   - 动态上下文切换               │   │
+│  │   - 浏览器工具 (22个)            │   │
+│  └─────────────────────────────────┘   │
+│                                         │
+│  ┌─────────────────────────────────┐   │
+│  │   PlaywrightManager             │   │
+│  │   instances: Map {              │   │
+│  │     1: { context, browser }     │   │
+│  │     2: { context, browser }     │   │
+│  │   }                             │   │
+│  │   activeInstanceId: 1           │   │
+│  └─────────────────────────────────┘   │
+│                                         │
+│  ┌─────────────────────────────────┐   │
+│  │   SQLite Database               │   │
+│  │   ~/.botbrowser-mcp/            │   │
+│  │   - browser_profiles            │   │
+│  │   - accounts                    │   │
+│  │   - browser_instances           │   │
+│  └─────────────────────────────────┘   │
+└─────────────────────────────────────────┘
+                 │
+                 ↓
+    ┌────────────────────────────┐
+    │   实际运行的浏览器          │
+    │   Instance 1: Chrome       │
+    │   Instance 2: Chrome       │
+    └────────────────────────────┘
+```
+
+## 技术特性
+
+### 多实例浏览器切换
+
+- **动态上下文切换**: 使用 `PlaywrightMCPProxy` 包装 @playwright/mcp，通过 `resetContext()` 清除缓存
+- **独立浏览器状态**: 每个实例维护独立的页面、会话和导航历史
+- **完整配置支持**: 提供包含超时设置的完整 BrowserServerBackend 配置
+
+**工作原理:**
+1. @playwright/mcp 的 Context 类会缓存 BrowserContext
+2. 调用 `switch_browser_instance` 后，清除 `_browserContextPromise` 缓存
+3. 下次工具调用时，自动使用当前活跃实例的上下文
+
+### 元数据字段
+
+账号的 `metadata` 字段支持任意格式，LLM 可自由存取：
+
+```
+# 键值对格式
+metadata: "password: abc123, 2fa: JBSWY3DP, email: backup@gmail.com"
+
+# JSON 格式
+metadata: '{"password":"abc123","2fa":"JBSWY3DP","recovery":["c1","c2"]}'
+
+# 自然语言
+metadata: "密码是 abc123，双因素认证是 JBSWY3DP，备用邮箱 backup@gmail.com"
+```
+
+## 数据存储
+
+所有数据存储在: `~/.botbrowser-mcp/botbrowser.db` (SQLite)
+
+**数据库表:**
+- `browser_profiles` - 浏览器配置
+- `accounts` - 账号信息
+- `browser_instances` - 运行中的实例
+
+可使用 SQLite 客户端查看：
+```bash
+sqlite3 ~/.botbrowser-mcp/botbrowser.db
+SELECT * FROM browser_profiles;
+```
+
+## 常见问题
+
+**Q: 如何知道哪个实例是活跃的？**  
+A: 使用 `list_browser_instances` 查看，`is_active: 1` 的实例就是当前活跃实例。
+
+**Q: 可以同时操作多个实例吗？**  
+A: 不可以。浏览器操作工具只作用于活跃实例，需要先 `switch_browser_instance` 切换。
+
+**Q: Cookie 什么时候保存？**  
+A: 停止实例时（`stop_browser_instance`）会自动保存到 `storage_state_path`。
+
+**Q: 孤立实例记录是什么？**  
+A: 如果程序异常退出，浏览器已关闭但数据库记录还在，使用 `cleanup_orphaned_instances` 清理。
+
+## 故障排查
+
+如果遇到 "Connection closed" 错误：
+1. 确保使用最新版本: `npm install -g botbrowser-mcp@latest`
+2. 尝试完整路径: `"command": "/usr/local/bin/botbrowser-mcp"`
+3. 检查 Node.js 已安装: `node --version`
+
+## 依赖
 
-If you get "Connection closed" error:
-1. Make sure you're using the latest version: `npm install -g botbrowser-mcp@latest`
-2. Try with full path: `"command": "/usr/local/bin/botbrowser-mcp"`
-3. Check Node.js is installed: `node --version`
+- Node.js 18+
+- @playwright/mcp - 浏览器自动化工具
+- playwright - 浏览器驱动
+- better-sqlite3 - SQLite 数据库
 
-## License
+## 许可证
 
 Apache-2.0
 

package/dist/cli.d.ts

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-/**
- * botbrowser-mcp CLI
- */
-export {};

package/dist/cli.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-/**
- * botbrowser-mcp CLI
- */
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { createConnection } from './index';
-(async () => {
-    // 直接使用 @playwright/mcp 的 createConnection
-    const server = await createConnection();
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-})();
-//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,CAAC,KAAK,IAAI,EAAE;IACV,0CAA0C;IAC1C,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC,CAAC,EAAE,CAAC"}