@pyrokine/mcp-chrome 1.0.0

package/dist/tools/wait.js

@@ -0,0 +1,254 @@
+/**
+ * wait 工具
+ *
+ * 等待条件：
+ * - element: 等待元素出现/消失/可见/隐藏
+ * - navigation: 等待导航完成
+ * - time: 固定等待时间
+ * - idle: 等待网络空闲
+ */
+import { z } from 'zod';
+import { formatErrorResponse, getSession, TimeoutError } from '../core/index.js';
+import { targetJsonSchema, targetZodSchema } from './schema.js';
+/**
+ * wait 工具定义
+ */
+export const waitToolDefinition = {
+    name: 'wait',
+    description: '等待条件：元素、导航、时间',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            for: {
+                type: 'string',
+                enum: ['element', 'navigation', 'time', 'idle'],
+                description: '等待类型',
+            },
+            target: {
+                ...targetJsonSchema,
+                description: '目标元素（for=element 时必填；navigation/time/idle 不需要）',
+            },
+            state: {
+                type: 'string',
+                enum: ['visible', 'hidden', 'attached', 'detached'],
+                description: '元素状态（element）',
+            },
+            ms: {
+                type: 'number',
+                description: '毫秒（time）',
+            },
+            timeout: {
+                type: 'number',
+                description: '超时',
+            },
+        },
+        required: ['for'],
+    },
+};
+/**
+ * wait 参数 schema
+ */
+const waitSchema = z.object({
+    for: z.enum(['element', 'navigation', 'time', 'idle']),
+    target: targetZodSchema.optional(),
+    state: z.enum(['visible', 'hidden', 'attached', 'detached']).optional(),
+    ms: z.number().optional(),
+    timeout: z.number().optional(),
+});
+/**
+ * wait 工具处理器
+ */
+export async function handleWait(params) {
+    try {
+        const args = waitSchema.parse(params);
+        const session = getSession();
+        const timeout = args.timeout ?? 30000;
+        switch (args.for) {
+            case 'element': {
+                if (!args.target) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        code: 'INVALID_ARGUMENT',
+                                        message: '等待元素需要 target 参数',
+                                    },
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const state = args.state ?? 'visible';
+                await waitForElement(session, args.target, state, timeout);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                waited: 'element',
+                                state,
+                            }),
+                        },
+                    ],
+                };
+            }
+            case 'navigation': {
+                // 等待页面加载完成
+                await waitForNavigation(session, timeout);
+                const sessionState = session.getState();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                waited: 'navigation',
+                                url: sessionState?.url,
+                                title: sessionState?.title,
+                            }),
+                        },
+                    ],
+                };
+            }
+            case 'time': {
+                if (!args.ms) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        code: 'INVALID_ARGUMENT',
+                                        message: '等待时间需要 ms 参数',
+                                    },
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                await new Promise((resolve) => setTimeout(resolve, args.ms));
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                waited: 'time',
+                                ms: args.ms,
+                            }),
+                        },
+                    ],
+                };
+            }
+            case 'idle': {
+                // 等待网络空闲
+                await waitForNetworkIdle(session, timeout);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                waited: 'idle',
+                            }),
+                        },
+                    ],
+                };
+            }
+            default:
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: {
+                                    code: 'INVALID_ARGUMENT',
+                                    message: `未知等待类型: ${args.for}`,
+                                },
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        return formatErrorResponse(error);
+    }
+}
+/**
+ * 等待元素
+ */
+async function waitForElement(session, target, state, timeout) {
+    const startTime = Date.now();
+    const retryDelay = 100;
+    while (Date.now() - startTime < timeout) {
+        try {
+            const locator = session.createLocator(target);
+            switch (state) {
+                case 'attached':
+                case 'visible': {
+                    // 尝试找到元素
+                    await locator.find();
+                    if (state === 'visible') {
+                        // 还需要检查可见性
+                        const box = await locator.getBoundingBox();
+                        if (box.width > 0 && box.height > 0) {
+                            return; // 元素可见
+                        }
+                    }
+                    else {
+                        return; // 元素存在
+                    }
+                    break;
+                }
+                case 'detached':
+                case 'hidden': {
+                    try {
+                        await locator.find();
+                        if (state === 'hidden') {
+                            // 元素存在，检查是否隐藏
+                            const box = await locator.getBoundingBox();
+                            if (box.width === 0 || box.height === 0) {
+                                return; // 元素隐藏
+                            }
+                        }
+                        // 元素仍然存在，继续等待
+                    }
+                    catch {
+                        // 元素不存在，符合预期
+                        return;
+                    }
+                    break;
+                }
+            }
+        }
+        catch {
+            // 元素未找到
+            if (state === 'detached' || state === 'hidden') {
+                return; // 符合预期
+            }
+            // 继续等待
+        }
+        await new Promise((resolve) => setTimeout(resolve, retryDelay));
+    }
+    throw new TimeoutError(`等待元素 ${JSON.stringify(target)} 状态 ${state} 超时 (${timeout}ms)`);
+}
+/**
+ * 等待导航完成（复用 session 的事件驱动实现）
+ */
+async function waitForNavigation(session, timeout) {
+    await session.waitForNavigation(timeout);
+}
+/**
+ * 等待网络空闲（复用 session 的事件驱动实现）
+ */
+async function waitForNetworkIdle(session, timeout) {
+    await session.waitForNetworkIdle(timeout);
+}
+//# sourceMappingURL=wait.js.map

package/dist/tools/wait.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@pyrokine/mcp-chrome",
+  "version": "1.0.0",
+  "description": "Chrome browser automation MCP Server using Chrome DevTools Protocol",
+  "main": "dist/index.js",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc -w",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "browser",
+    "automation",
+    "cdp",
+    "chrome",
+    "puppeteer"
+  ],
+  "author": "Pyrokine",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "ws": "^8.18.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "mcp-chrome": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "scripts"
+  ]
+}

package/scripts/start-chrome-headless.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+
+# MCP Browser - Chrome 无头模式启动脚本
+# 启动无头 Chrome（适合服务器环境）
+
+PORT="${1:-9222}"
+
+echo "Starting Chrome in headless mode on port $PORT..."
+
+# 检测操作系统和 Chrome 路径
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+    if command -v google-chrome &> /dev/null; then
+        CHROME_PATH="google-chrome"
+    elif command -v google-chrome-stable &> /dev/null; then
+        CHROME_PATH="google-chrome-stable"
+    elif command -v chromium &> /dev/null; then
+        CHROME_PATH="chromium"
+    else
+        echo "Error: Chrome/Chromium not found"
+        exit 1
+    fi
+else
+    echo "Error: Unsupported OS"
+    exit 1
+fi
+
+# 启动无头 Chrome
+"$CHROME_PATH" \
+    --headless=new \
+    --remote-debugging-port="$PORT" \
+    --disable-gpu \
+    --no-sandbox \
+    --disable-dev-shm-usage \
+    --window-size=1920,1080 \
+    "$@"

package/scripts/start-chrome.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+
+# MCP Browser - Chrome 启动脚本
+# 启动带远程调试端口的 Chrome 浏览器
+
+PORT="${1:-9222}"
+PROFILE_DIR="${HOME}/.chrome-mcp-profile"
+
+echo "Starting Chrome with remote debugging on port $PORT..."
+echo "Profile directory: $PROFILE_DIR"
+
+# 检测操作系统
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    # macOS
+    CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+    # Linux
+    if command -v google-chrome &> /dev/null; then
+        CHROME_PATH="google-chrome"
+    elif command -v google-chrome-stable &> /dev/null; then
+        CHROME_PATH="google-chrome-stable"
+    elif command -v chromium &> /dev/null; then
+        CHROME_PATH="chromium"
+    elif command -v chromium-browser &> /dev/null; then
+        CHROME_PATH="chromium-browser"
+    else
+        echo "Error: Chrome/Chromium not found"
+        exit 1
+    fi
+else
+    echo "Error: Unsupported OS"
+    exit 1
+fi
+
+# 启动 Chrome
+"$CHROME_PATH" \
+    --remote-debugging-port="$PORT" \
+    --user-data-dir="$PROFILE_DIR" \
+    --no-first-run \
+    --no-default-browser-check \
+    "$@"