@pyrokine/mcp-chrome 1.0.0

package/dist/tools/browse.js

@@ -0,0 +1,368 @@
+/**
+ * browse 工具
+ *
+ * 浏览器管理与导航：
+ * - launch: 启动新浏览器
+ * - connect: 连接已运行的浏览器
+ * - list: 列出所有可用页面
+ * - attach: 附加到指定页面
+ * - open: 打开 URL
+ * - back/forward: 前进后退
+ * - refresh: 刷新
+ * - close: 关闭浏览器
+ */
+import { z } from 'zod';
+import { formatErrorResponse, getSession } from '../core/index.js';
+/**
+ * browse 工具定义
+ */
+export const browseToolDefinition = {
+    name: 'browse',
+    description: '浏览器管理与导航：启动、连接、列出页面、打开 URL、导航',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: [
+                    'launch',
+                    'connect',
+                    'list',
+                    'attach',
+                    'open',
+                    'back',
+                    'forward',
+                    'refresh',
+                    'close',
+                ],
+                description: '操作类型',
+            },
+            // launch 参数
+            executablePath: {
+                type: 'string',
+                description: 'Chrome 可执行文件路径（launch）。不指定则自动查找',
+            },
+            incognito: {
+                type: 'boolean',
+                description: '是否以隐身模式启动（launch）',
+            },
+            headless: {
+                type: 'boolean',
+                description: '是否无头模式（launch）。注意：无头模式易被检测',
+            },
+            userDataDir: {
+                type: 'string',
+                description: '用户数据目录（launch）。指定后可复用登录状态',
+            },
+            stealth: {
+                type: 'string',
+                enum: ['off', 'safe', 'aggressive'],
+                description: '反检测模式（launch/connect）。off=关闭，safe=最小改动（默认），aggressive=完整伪装',
+            },
+            // connect 参数
+            port: {
+                type: 'number',
+                description: '调试端口（connect）',
+            },
+            host: {
+                type: 'string',
+                description: '调试主机（connect）',
+            },
+            // attach 参数
+            targetId: {
+                type: 'string',
+                description: '目标 ID（attach）。从 list 结果中获取',
+            },
+            // open 参数
+            url: {
+                type: 'string',
+                description: '目标 URL（open）',
+            },
+            wait: {
+                type: 'string',
+                enum: ['load', 'domcontentloaded', 'networkidle'],
+                description: '等待条件（open/refresh）',
+            },
+            // refresh 参数
+            ignoreCache: {
+                type: 'boolean',
+                description: '刷新时是否忽略缓存（refresh）',
+            },
+            // 通用参数
+            timeout: {
+                type: 'number',
+                description: '超时毫秒',
+            },
+        },
+        required: ['action'],
+    },
+};
+/**
+ * browse 参数 schema
+ */
+const browseSchema = z.object({
+    action: z.enum([
+        'launch',
+        'connect',
+        'list',
+        'attach',
+        'open',
+        'back',
+        'forward',
+        'refresh',
+        'close',
+    ]),
+    executablePath: z.string().optional(),
+    incognito: z.boolean().optional(),
+    headless: z.boolean().optional(),
+    userDataDir: z.string().optional(),
+    stealth: z.enum(['off', 'safe', 'aggressive']).optional(),
+    port: z.number().optional(),
+    host: z.string().optional(),
+    targetId: z.string().optional(),
+    url: z.string().optional(),
+    wait: z.enum(['load', 'domcontentloaded', 'networkidle']).optional(),
+    ignoreCache: z.boolean().optional(),
+    timeout: z.number().optional(),
+});
+/**
+ * browse 工具处理器
+ */
+export async function handleBrowse(params) {
+    try {
+        const args = browseSchema.parse(params);
+        const session = getSession();
+        switch (args.action) {
+            case 'launch': {
+                const target = await session.launch({
+                    executablePath: args.executablePath,
+                    incognito: args.incognito ?? false,
+                    headless: args.headless ?? false,
+                    userDataDir: args.userDataDir,
+                    timeout: args.timeout ?? 30000,
+                    stealth: args.stealth,
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'launch',
+                                target,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'connect': {
+                if (!args.port) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        code: 'INVALID_ARGUMENT',
+                                        message: '缺少 port 参数',
+                                        suggestion: '请指定 port 参数，例如：browse(action="connect", port=9222)',
+                                    },
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const target = await session.connect({
+                    host: args.host ?? '127.0.0.1',
+                    port: args.port,
+                    timeout: args.timeout ?? 30000,
+                    stealth: args.stealth,
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'connect',
+                                target,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'list': {
+                const targets = await session.listTargets();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'list',
+                                targets,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'attach': {
+                if (!args.targetId) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        code: 'INVALID_ARGUMENT',
+                                        message: '缺少 targetId 参数',
+                                        suggestion: '请先使用 browse(action="list") 获取可用页面，然后使用 targetId 附加',
+                                    },
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                await session.attachToTarget(args.targetId);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'attach',
+                                targetId: args.targetId,
+                            }),
+                        },
+                    ],
+                };
+            }
+            case 'open': {
+                if (!args.url) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        code: 'INVALID_ARGUMENT',
+                                        message: '缺少 url 参数',
+                                        suggestion: '请指定 url 参数',
+                                    },
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                await session.navigate(args.url, {
+                    wait: args.wait,
+                    timeout: args.timeout ?? 30000,
+                });
+                const state = session.getState();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'open',
+                                url: state?.url,
+                                title: state?.title,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'back': {
+                await session.goBack();
+                const state = session.getState();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'back',
+                                url: state?.url,
+                                title: state?.title,
+                            }),
+                        },
+                    ],
+                };
+            }
+            case 'forward': {
+                await session.goForward();
+                const state = session.getState();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'forward',
+                                url: state?.url,
+                                title: state?.title,
+                            }),
+                        },
+                    ],
+                };
+            }
+            case 'refresh': {
+                await session.reload({
+                    ignoreCache: args.ignoreCache ?? false,
+                    timeout: args.timeout ?? 30000,
+                });
+                const state = session.getState();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'refresh',
+                                url: state?.url,
+                                title: state?.title,
+                            }),
+                        },
+                    ],
+                };
+            }
+            case 'close': {
+                await session.close();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'close',
+                            }),
+                        },
+                    ],
+                };
+            }
+            default:
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: {
+                                    code: 'INVALID_ARGUMENT',
+                                    message: `未知操作: ${args.action}`,
+                                },
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        return formatErrorResponse(error);
+    }
+}
+//# sourceMappingURL=browse.js.map

package/dist/tools/browse.js.map

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

package/dist/tools/cookies.d.ts

@@ -0,0 +1,75 @@
+/**
+ * cookies 工具
+ *
+ * Cookie 管理：
+ * - get: 获取 cookies
+ * - set: 设置 cookie
+ * - delete: 删除 cookie
+ * - clear: 清空所有 cookies
+ */
+/**
+ * cookies 工具定义
+ */
+export declare const cookiesToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            value: {
+                type: string;
+                description: string;
+            };
+            options: {
+                type: string;
+                properties: {
+                    domain: {
+                        type: string;
+                    };
+                    path: {
+                        type: string;
+                    };
+                    expires: {
+                        type: string;
+                    };
+                    httpOnly: {
+                        type: string;
+                    };
+                    secure: {
+                        type: string;
+                    };
+                    sameSite: {
+                        type: string;
+                        enum: string[];
+                    };
+                };
+                description: string;
+            };
+            output: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * cookies 工具处理器
+ */
+export declare function handleCookies(params: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=cookies.d.ts.map

package/dist/tools/cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/tools/cookies.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCjC,CAAA;AAwBD;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1D,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC,CAwKD"}

package/dist/tools/cookies.js

@@ -0,0 +1,230 @@
+/**
+ * cookies 工具
+ *
+ * Cookie 管理：
+ * - get: 获取 cookies
+ * - set: 设置 cookie
+ * - delete: 删除 cookie
+ * - clear: 清空所有 cookies
+ */
+import { writeFile } from 'fs/promises';
+import { z } from 'zod';
+import { formatErrorResponse, getSession } from '../core/index.js';
+/**
+ * cookies 工具定义
+ */
+export const cookiesToolDefinition = {
+    name: 'cookies',
+    description: 'Cookie 管理：获取、设置、删除、清空',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: ['get', 'set', 'delete', 'clear'],
+                description: '操作类型',
+            },
+            name: {
+                type: 'string',
+                description: 'Cookie 名（get/set/delete）',
+            },
+            value: {
+                type: 'string',
+                description: 'Cookie 值（set）',
+            },
+            options: {
+                type: 'object',
+                properties: {
+                    domain: { type: 'string' },
+                    path: { type: 'string' },
+                    expires: { type: 'number' },
+                    httpOnly: { type: 'boolean' },
+                    secure: { type: 'boolean' },
+                    sameSite: { type: 'string', enum: ['Strict', 'Lax', 'None'] },
+                },
+                description: 'Cookie 选项（set）',
+            },
+            output: {
+                type: 'string',
+                description: '输出文件路径（get）。若指定，cookies 导出为 JSON 文件',
+            },
+        },
+        required: ['action'],
+    },
+};
+/**
+ * cookies 参数 schema
+ */
+const cookiesSchema = z.object({
+    action: z.enum(['get', 'set', 'delete', 'clear']),
+    name: z.string().optional(),
+    value: z.string().optional(),
+    options: z
+        .object({
+        domain: z.string().optional(),
+        path: z.string().optional(),
+        expires: z.number().optional(),
+        httpOnly: z.boolean().optional(),
+        secure: z.boolean().optional(),
+        sameSite: z.enum(['Strict', 'Lax', 'None']).optional(),
+    })
+        .optional(),
+    output: z.string().optional(),
+});
+/**
+ * cookies 工具处理器
+ */
+export async function handleCookies(params) {
+    try {
+        const args = cookiesSchema.parse(params);
+        const session = getSession();
+        switch (args.action) {
+            case 'get': {
+                const cookies = await session.getCookies();
+                // 如果指定了 name，只返回匹配的 cookie
+                const result = args.name
+                    ? cookies.filter((c) => c.name === args.name)
+                    : cookies;
+                if (args.output) {
+                    await writeFile(args.output, JSON.stringify(result, null, 2), 'utf-8');
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: true,
+                                    action: 'get',
+                                    output: args.output,
+                                    count: result.length,
+                                }),
+                            },
+                        ],
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'get',
+                                cookies: result,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'set': {
+                if (!args.name) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        code: 'INVALID_ARGUMENT',
+                                        message: '设置 cookie 需要 name 参数',
+                                    },
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                if (args.value === undefined) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        code: 'INVALID_ARGUMENT',
+                                        message: '设置 cookie 需要 value 参数',
+                                    },
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                await session.setCookie(args.name, args.value, args.options);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'set',
+                                name: args.name,
+                            }),
+                        },
+                    ],
+                };
+            }
+            case 'delete': {
+                if (!args.name) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        code: 'INVALID_ARGUMENT',
+                                        message: '删除 cookie 需要 name 参数',
+                                    },
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                await session.deleteCookie(args.name);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'delete',
+                                name: args.name,
+                            }),
+                        },
+                    ],
+                };
+            }
+            case 'clear': {
+                await session.clearCookies();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                action: 'clear',
+                            }),
+                        },
+                    ],
+                };
+            }
+            default:
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: {
+                                    code: 'INVALID_ARGUMENT',
+                                    message: `未知操作: ${args.action}`,
+                                },
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        return formatErrorResponse(error);
+    }
+}
+//# sourceMappingURL=cookies.js.map