@cjwddz/browser-server 0.1.0-alpha

package/README.md

@@ -0,0 +1,148 @@
+# @cjwddz/browser-server
+
+面向 AI Agent 的自托管常驻浏览器服务。
+
+## 解决的问题
+
+AI Agent 在无 GUI 的远程服务器上操作浏览器时面临的核心难题：
+
+- 浏览器生命周期绑定 Agent 对话，对话结束状态全丢
+- 跨天登录态无法保持，每次都要重新登录
+- 验证码、密码等场景 AI 无法处理，卡住无解
+- 多 Agent 共用浏览器互相干扰
+
+## 核心特性
+
+- **常驻浏览器** — 浏览器 7×24 运行，不因 Agent 会话结束而关闭
+- **状态完整保持** — Cookie、localStorage、页面 JS 上下文持续存活，跨天登录态不丢
+- **Web 端实时操控** — 用户随时从浏览器打开管理页面，直接查看和操作浏览器（验证码、密码等）
+- **Agent 隔离** — 每个会话独立 BrowserContext，Cookie/存储完全隔离
+- **MCP 集成** — 15 个浏览器操控工具，支持 Streamable HTTP 协议
+- **进程守护** — Chromium 崩溃自动重启
+
+## 系统依赖
+
+```bash
+# Ubuntu/Debian
+sudo apt-get install -y xvfb x11vnc chromium-browser
+```
+
+## 安装
+
+```bash
+npm install -g @cjwddz/browser-server
+```
+
+## 使用
+
+### 启动服务
+
+```bash
+browser-server start -u admin -p mypassword
+```
+
+### 完整参数
+
+```bash
+browser-server start \
+  -u admin \           # Web 管理登录用户名（必填）
+  -p mypassword \      # Web 管理登录密码（必填）
+  -w 33000 \           # Web 管理端口（默认 33000）
+  -m 33001 \           # MCP 服务端口（默认 33001）
+  -d ~/.browser-server \ # 服务根目录（默认 ~/.browser-server）
+  --host 0.0.0.0       # 监听地址（默认 0.0.0.0）
+```
+
+### 其他命令
+
+```bash
+browser-server stop       # 停止服务
+browser-server restart -u admin -p mypassword  # 重启
+browser-server status     # 查看状态
+```
+
+## 使用流程
+
+1. 启动服务
+2. 浏览器打开 `http://localhost:33000`，输入账号密码
+3. 点「新建会话」，输入名称
+4. 点「MCP 配置」，复制 JSON 配置
+5. 粘贴到 Cursor / Claude Desktop 的 MCP 配置中
+6. Agent 开始操作浏览器
+7. 需要人工介入时（验证码等），在管理页面点「查看浏览器」直接操作
+
+## 架构
+
+```
+browser-server
+├── Web 管理 (:33000)          ← 用户浏览器访问
+│   ├── 会话列表（创建/删除）
+│   ├── 查看浏览器（noVNC 实时画面 + 操作）
+│   └── MCP 配置（一键复制）
+│
+├── MCP 服务 (:33001)          ← Agent 连接
+│   └── 15 个浏览器操控工具
+│
+└── 每个会话 = 独立进程组
+    ├── Xvfb (虚拟显示器)
+    ├── Chromium (--user-data-dir 持久化)
+    └── x11vnc (VNC 服务)
+```
+
+## MCP 工具列表
+
+| 工具 | 说明 |
+|------|------|
+| navigate_page | 导航到指定 URL |
+| click | 点击页面元素 |
+| fill | 填写输入框 |
+| hover | 悬停在元素上 |
+| press_key | 按下键盘按键 |
+| take_screenshot | 截取页面截图 |
+| take_snapshot | 获取页面 DOM 快照 |
+| evaluate_script | 执行 JavaScript |
+| list_pages | 列出所有标签页 |
+| new_page | 打开新标签页 |
+| close_page | 关闭当前标签页 |
+| select_page | 切换标签页 |
+| wait_for | 等待元素出现或指定时间 |
+| emulate | 模拟移动设备 |
+| resize_page | 调整视口大小 |
+
+## 数据目录结构
+
+```
+~/.browser-server/
+├── server.pid          # 守护进程 PID
+├── server.json         # 运行配置
+├── sessions.json       # 会话列表
+├── server.log          # 服务日志
+├── <session-id>/       # 会话目录
+│   ├── chrome-data/    # Chromium 用户数据（cookie/storage 等）
+│   └── chrome.log      # Chromium 日志
+└── ...
+```
+
+## Docker 部署
+
+适用于 macOS / Windows / 任何不想手动安装系统依赖的场景：
+
+```bash
+# 构建镜像
+cd packages/browser-server
+npm run build
+docker build -t browser-server .
+
+# 运行
+docker run -d \
+  -p 33000:33000 \
+  -p 33001:33001 \
+  -v ~/.browser-server:/data \
+  browser-server start -u admin -p mypassword -d /data --host 0.0.0.0
+```
+
+镜像内已包含 Chromium、Xvfb、x11vnc 和中文字体，无需额外配置。
+
+## License
+
+MIT

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { fork } from 'node:child_process';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { resolveDataDir, ensureDataDir, loadPid, removePid, isProcessRunning, loadServerConfig, saveServerConfig, } from './utils/config.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const program = new Command();
+program.name('browser-server').description('Self-hosted headless browser service for AI agents').version('0.1.0');
+program
+    .command('start')
+    .description('启动浏览器服务（守护进程模式）')
+    .requiredOption('-u, --user <username>', 'Web 管理登录用户名')
+    .requiredOption('-p, --pass <password>', 'Web 管理登录密码')
+    .option('-w, --web-port <port>', 'Web 管理端口', '33000')
+    .option('-m, --mcp-port <port>', 'MCP 服务端口', '33001')
+    .option('-d, --data-dir <path>', '服务根目录', resolveDataDir())
+    .option('--host <host>', '监听地址', '0.0.0.0')
+    .action(async (opts) => {
+    const dataDir = resolveDataDir(opts.dataDir);
+    const existingPid = loadPid(dataDir);
+    if (existingPid && isProcessRunning(existingPid)) {
+        console.error(`服务已在运行 (PID: ${existingPid})。如需重启请使用 restart 命令。`);
+        process.exit(1);
+    }
+    const config = {
+        webPort: parseInt(opts.webPort, 10),
+        mcpPort: parseInt(opts.mcpPort, 10),
+        host: opts.host,
+        user: opts.user,
+        pass: opts.pass,
+        dataDir,
+    };
+    ensureDataDir(dataDir);
+    saveServerConfig(config);
+    const daemonScript = path.join(__dirname, 'daemon.js');
+    const child = fork(daemonScript, [], {
+        detached: true,
+        stdio: 'ignore',
+        env: { ...process.env, BROWSER_SERVER_DATA_DIR: dataDir },
+    });
+    child.unref();
+    console.log(`browser-server 已启动 (PID: ${child.pid})`);
+    console.log(`  Web 管理: http://${config.host}:${config.webPort}`);
+    console.log(`  MCP 服务: http://${config.host}:${config.mcpPort}`);
+    console.log(`  数据目录: ${dataDir}`);
+    process.exit(0);
+});
+program
+    .command('stop')
+    .description('停止浏览器服务')
+    .option('-d, --data-dir <path>', '服务根目录', resolveDataDir())
+    .action(async (opts) => {
+    const dataDir = resolveDataDir(opts.dataDir);
+    const pid = loadPid(dataDir);
+    if (!pid || !isProcessRunning(pid)) {
+        console.log('browser-server 未运行');
+        removePid(dataDir);
+        process.exit(0);
+    }
+    console.log(`正在停止 browser-server (PID: ${pid})...`);
+    process.kill(pid, 'SIGTERM');
+    const timeout = 10_000;
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+        if (!isProcessRunning(pid)) {
+            removePid(dataDir);
+            console.log('browser-server 已停止');
+            process.exit(0);
+        }
+        await sleep(500);
+    }
+    console.warn('优雅退出超时，强制终止...');
+    try {
+        process.kill(pid, 'SIGKILL');
+    }
+    catch {
+        // already dead
+    }
+    removePid(dataDir);
+    console.log('browser-server 已强制停止');
+    process.exit(0);
+});
+program
+    .command('restart')
+    .description('重启浏览器服务（等同于 stop + start）')
+    .requiredOption('-u, --user <username>', 'Web 管理登录用户名')
+    .requiredOption('-p, --pass <password>', 'Web 管理登录密码')
+    .option('-w, --web-port <port>', 'Web 管理端口', '33000')
+    .option('-m, --mcp-port <port>', 'MCP 服务端口', '33001')
+    .option('-d, --data-dir <path>', '服务根目录', resolveDataDir())
+    .option('--host <host>', '监听地址', '0.0.0.0')
+    .action(async (opts) => {
+    const dataDir = resolveDataDir(opts.dataDir);
+    const pid = loadPid(dataDir);
+    if (pid && isProcessRunning(pid)) {
+        console.log(`正在停止 browser-server (PID: ${pid})...`);
+        process.kill(pid, 'SIGTERM');
+        const start = Date.now();
+        while (Date.now() - start < 10_000) {
+            if (!isProcessRunning(pid))
+                break;
+            await sleep(500);
+        }
+        if (isProcessRunning(pid)) {
+            try {
+                process.kill(pid, 'SIGKILL');
+            }
+            catch { /* */ }
+        }
+        removePid(dataDir);
+        console.log('已停止');
+    }
+    // re-trigger start
+    const config = {
+        webPort: parseInt(opts.webPort, 10),
+        mcpPort: parseInt(opts.mcpPort, 10),
+        host: opts.host,
+        user: opts.user,
+        pass: opts.pass,
+        dataDir,
+    };
+    ensureDataDir(dataDir);
+    saveServerConfig(config);
+    const daemonScript = path.join(__dirname, 'daemon.js');
+    const child = fork(daemonScript, [], {
+        detached: true,
+        stdio: 'ignore',
+        env: { ...process.env, BROWSER_SERVER_DATA_DIR: dataDir },
+    });
+    child.unref();
+    console.log(`browser-server 已重启 (PID: ${child.pid})`);
+    console.log(`  Web 管理: http://${config.host}:${config.webPort}`);
+    console.log(`  MCP 服务: http://${config.host}:${config.mcpPort}`);
+    process.exit(0);
+});
+program
+    .command('status')
+    .description('查看服务状态')
+    .option('-d, --data-dir <path>', '服务根目录', resolveDataDir())
+    .action((opts) => {
+    const dataDir = resolveDataDir(opts.dataDir);
+    const pid = loadPid(dataDir);
+    if (!pid || !isProcessRunning(pid)) {
+        console.log('browser-server 未运行');
+        process.exit(0);
+    }
+    const config = loadServerConfig(dataDir);
+    console.log(`browser-server 运行中 (PID: ${pid})`);
+    if (config) {
+        console.log(`  Web 管理: http://${config.host}:${config.webPort}`);
+        console.log(`  MCP 服务: http://${config.host}:${config.mcpPort}`);
+        console.log(`  数据目录: ${config.dataDir}`);
+    }
+});
+program.parse();
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/daemon.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=daemon.d.ts.map

package/dist/daemon.d.ts.map

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

package/dist/daemon.js

@@ -0,0 +1,57 @@
+import { loadServerConfig, savePid, removePid, } from './utils/config.js';
+import { initLogger, log, closeLogger } from './utils/logger.js';
+import { SessionManager } from './session/session-manager.js';
+import { WebServer } from './server/web-server.js';
+import { McpServer } from './server/mcp-server.js';
+const dataDir = process.env.BROWSER_SERVER_DATA_DIR;
+if (!dataDir) {
+    console.error('BROWSER_SERVER_DATA_DIR 环境变量未设置');
+    process.exit(1);
+}
+const config = loadServerConfig(dataDir);
+if (!config) {
+    console.error('无法读取服务配置');
+    process.exit(1);
+}
+initLogger(dataDir);
+savePid(dataDir, process.pid);
+const sessionManager = new SessionManager(dataDir);
+const webServer = new WebServer(config, sessionManager);
+const mcpServer = new McpServer(config, sessionManager);
+async function startup() {
+    log.info('browser-server 启动中...');
+    log.info(`PID: ${process.pid}`);
+    log.info(`Web 端口: ${config.webPort}, MCP 端口: ${config.mcpPort}`);
+    await sessionManager.restoreSessions();
+    await webServer.start();
+    await mcpServer.start();
+    log.info('browser-server 启动完成');
+}
+async function shutdown() {
+    log.info('browser-server 正在关闭...');
+    await mcpServer.stop();
+    await webServer.stop();
+    await sessionManager.stopAllSessions();
+    removePid(dataDir);
+    closeLogger();
+}
+process.on('SIGTERM', async () => {
+    await shutdown();
+    process.exit(0);
+});
+process.on('SIGINT', async () => {
+    await shutdown();
+    process.exit(0);
+});
+process.on('uncaughtException', (err) => {
+    log.error('未捕获的异常:', err.message);
+});
+process.on('unhandledRejection', (reason) => {
+    log.error('未处理的 Promise rejection:', reason);
+});
+startup().catch((err) => {
+    log.error('启动失败:', err.message);
+    removePid(dataDir);
+    process.exit(1);
+});
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { SessionManager } from './session/session-manager.js';
+export { ProcessGroup } from './session/process-group.js';
+export { WebServer } from './server/web-server.js';
+export { McpServer } from './server/mcp-server.js';
+export { ConnectionPool } from './mcp/connection-pool.js';
+export { defineTools } from './mcp/tools.js';
+export type { ServerConfig, SessionInfo, SessionsData } from './utils/types.js';
+//# 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":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { SessionManager } from './session/session-manager.js';
+export { ProcessGroup } from './session/process-group.js';
+export { WebServer } from './server/web-server.js';
+export { McpServer } from './server/mcp-server.js';
+export { ConnectionPool } from './mcp/connection-pool.js';
+export { defineTools } from './mcp/tools.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/mcp/connection-pool.d.ts

@@ -0,0 +1,14 @@
+import type { BrowserConnection } from './tools.js';
+/**
+ * 管理到各 session 的 Playwright CDP 连接。
+ * 懒加载：首次访问某 session 时建立连接，之后缓存复用。
+ */
+export declare class ConnectionPool {
+    private connections;
+    private connecting;
+    getConnection(sessionId: string, cdpPort: number): Promise<BrowserConnection>;
+    private doConnect;
+    disconnect(sessionId: string): Promise<void>;
+    disconnectAll(): Promise<void>;
+}
+//# sourceMappingURL=connection-pool.d.ts.map

package/dist/mcp/connection-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-pool.d.ts","sourceRoot":"","sources":["../../src/mcp/connection-pool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,UAAU,CAAsD;IAElE,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;YA0BrE,SAAS;IAcjB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5C,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAKrC"}

package/dist/mcp/connection-pool.js

@@ -0,0 +1,65 @@
+import { chromium } from 'playwright-core';
+import { log } from '../utils/logger.js';
+/**
+ * 管理到各 session 的 Playwright CDP 连接。
+ * 懒加载：首次访问某 session 时建立连接，之后缓存复用。
+ */
+export class ConnectionPool {
+    connections = new Map();
+    connecting = new Map();
+    async getConnection(sessionId, cdpPort) {
+        const existing = this.connections.get(sessionId);
+        if (existing) {
+            try {
+                await existing.activePage.evaluate('1');
+                return existing;
+            }
+            catch {
+                log.warn(`[${sessionId}] CDP 连接失效，重新连接...`);
+                this.connections.delete(sessionId);
+            }
+        }
+        const inflight = this.connecting.get(sessionId);
+        if (inflight)
+            return inflight;
+        const promise = this.doConnect(sessionId, cdpPort);
+        this.connecting.set(sessionId, promise);
+        try {
+            const conn = await promise;
+            this.connections.set(sessionId, conn);
+            return conn;
+        }
+        finally {
+            this.connecting.delete(sessionId);
+        }
+    }
+    async doConnect(sessionId, cdpPort) {
+        const cdpUrl = `http://127.0.0.1:${cdpPort}`;
+        log.info(`[${sessionId}] 连接 CDP: ${cdpUrl}`);
+        const browser = await chromium.connectOverCDP(cdpUrl, { timeout: 10_000 });
+        const contexts = browser.contexts();
+        const context = contexts[0] || await browser.newContext();
+        const pages = context.pages();
+        const activePage = pages[0] || await context.newPage();
+        log.info(`[${sessionId}] CDP 连接成功，${pages.length} 个标签页`);
+        return { browser, context, activePage, pages };
+    }
+    async disconnect(sessionId) {
+        const conn = this.connections.get(sessionId);
+        if (conn) {
+            try {
+                await conn.browser.close();
+            }
+            catch {
+                // ignore
+            }
+            this.connections.delete(sessionId);
+        }
+    }
+    async disconnectAll() {
+        for (const [id] of this.connections) {
+            await this.disconnect(id);
+        }
+    }
+}
+//# sourceMappingURL=connection-pool.js.map

package/dist/mcp/connection-pool.js.map

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