@pyrokine/mcp-chrome 1.0.0

package/dist/tools/cookies.js.map

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

package/dist/tools/evaluate.d.ts

@@ -0,0 +1,45 @@
+/**
+ * evaluate 工具
+ *
+ * 在页面上下文执行 JavaScript
+ */
+/**
+ * evaluate 工具定义
+ */
+export declare const evaluateToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            script: {
+                type: string;
+                description: string;
+            };
+            args: {
+                type: string;
+                description: string;
+            };
+            output: {
+                type: string;
+                description: string;
+            };
+            timeout: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * evaluate 工具处理器
+ */
+export declare function handleEvaluate(params: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=evaluate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/tools/evaluate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;CAyBlC,CAAA;AAcD;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC3D,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,CA4CD"}

package/dist/tools/evaluate.js

@@ -0,0 +1,85 @@
+/**
+ * evaluate 工具
+ *
+ * 在页面上下文执行 JavaScript
+ */
+import { writeFile } from 'fs/promises';
+import { z } from 'zod';
+import { formatErrorResponse, getSession } from '../core/index.js';
+/**
+ * evaluate 工具定义
+ */
+export const evaluateToolDefinition = {
+    name: 'evaluate',
+    description: '在页面上下文执行 JavaScript',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            script: {
+                type: 'string',
+                description: 'JavaScript 代码',
+            },
+            args: {
+                type: 'array',
+                description: '传递给脚本的参数',
+            },
+            output: {
+                type: 'string',
+                description: '输出文件路径（可选）。若指定，结果序列化为 JSON 写入文件',
+            },
+            timeout: {
+                type: 'number',
+                description: '脚本执行超时',
+            },
+        },
+        required: ['script'],
+    },
+};
+/**
+ * evaluate 参数 schema
+ */
+const evaluateSchema = z.object({
+    script: z.string(),
+    args: z.array(z.unknown()).optional(),
+    output: z.string().optional(),
+    timeout: z.number().optional(),
+});
+/**
+ * evaluate 工具处理器
+ */
+export async function handleEvaluate(params) {
+    try {
+        const args = evaluateSchema.parse(params);
+        const session = getSession();
+        const result = await session.evaluate(args.script, args.args, args.timeout);
+        if (args.output) {
+            await writeFile(args.output, JSON.stringify(result, null, 2), 'utf-8');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            output: args.output,
+                        }),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        result,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return formatErrorResponse(error);
+    }
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/tools/evaluate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../src/tools/evaluate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAA;AACrC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAA;AACrB,OAAO,EAAC,mBAAmB,EAAE,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAEhE;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,qBAAqB;IAClC,WAAW,EAAE;QACT,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACR,MAAM,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,eAAe;aAC/B;YACD,IAAI,EAAE;gBACF,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,UAAU;aAC1B;YACD,MAAM,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aACjD;YACD,OAAO,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,QAAQ;aACxB;SACJ;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACvB;CACJ,CAAA;AAED;;GAEG;AACH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACI,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAA;AAIlC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAe;IAIhD,IAAI,CAAC;QACD,MAAM,IAAI,GAAM,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC5C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;QAE5B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAE3E,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,SAAS,CACX,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAC/B,OAAO,CACV,CAAA;YACD,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACI,OAAO,EAAE,IAAI;4BACb,MAAM,EAAE,IAAI,CAAC,MAAM;yBACtB,CAAC;qBAC1B;iBACJ;aACJ,CAAA;QACL,CAAC;QAED,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB;wBACI,OAAO,EAAE,IAAI;wBACb,MAAM;qBACT,EACD,IAAI,EACJ,CAAC,CACJ;iBACJ;aACJ;SACJ,CAAA;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAA;IACrC,CAAC;AACL,CAAC"}

package/dist/tools/extract.d.ts

@@ -0,0 +1,213 @@
+/**
+ * extract 工具
+ *
+ * 提取页面内容：
+ * - text: 文本内容
+ * - html: HTML 源码
+ * - attribute: 元素属性
+ * - screenshot: 截图
+ * - state: 页面状态（精简的可交互元素列表）
+ */
+/**
+ * extract 工具定义
+ */
+export declare const extractToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            target: {
+                description: string;
+                oneOf: readonly [{
+                    readonly type: "object";
+                    readonly title: "可访问性树定位";
+                    readonly description: "通过 ARIA role 和 name 定位元素";
+                    readonly properties: {
+                        readonly role: {
+                            readonly type: "string";
+                            readonly description: "ARIA role（如 button、link、textbox）";
+                        };
+                        readonly name: {
+                            readonly type: "string";
+                            readonly description: "可访问名称（可选）";
+                        };
+                    };
+                    readonly required: readonly ["role"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly title: "文本内容定位";
+                    readonly description: "通过元素文本内容定位";
+                    readonly properties: {
+                        readonly text: {
+                            readonly type: "string";
+                            readonly description: "文本内容";
+                        };
+                        readonly exact: {
+                            readonly type: "boolean";
+                            readonly description: "是否精确匹配（默认 false）";
+                        };
+                    };
+                    readonly required: readonly ["text"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly title: "Label 定位";
+                    readonly description: "通过表单 label 文本定位关联的输入元素";
+                    readonly properties: {
+                        readonly label: {
+                            readonly type: "string";
+                            readonly description: "label 文本";
+                        };
+                        readonly exact: {
+                            readonly type: "boolean";
+                            readonly description: "是否精确匹配（默认 false）";
+                        };
+                    };
+                    readonly required: readonly ["label"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly title: "Placeholder 定位";
+                    readonly description: "通过输入框的 placeholder 属性定位";
+                    readonly properties: {
+                        readonly placeholder: {
+                            readonly type: "string";
+                            readonly description: "placeholder 文本";
+                        };
+                        readonly exact: {
+                            readonly type: "boolean";
+                            readonly description: "是否精确匹配（默认 false）";
+                        };
+                    };
+                    readonly required: readonly ["placeholder"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly title: "Title 属性定位";
+                    readonly description: "通过元素的 title 属性定位";
+                    readonly properties: {
+                        readonly title: {
+                            readonly type: "string";
+                            readonly description: "title 属性值";
+                        };
+                        readonly exact: {
+                            readonly type: "boolean";
+                            readonly description: "是否精确匹配（默认 false）";
+                        };
+                    };
+                    readonly required: readonly ["title"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly title: "Alt 属性定位";
+                    readonly description: "通过图片的 alt 属性定位";
+                    readonly properties: {
+                        readonly alt: {
+                            readonly type: "string";
+                            readonly description: "alt 属性值";
+                        };
+                        readonly exact: {
+                            readonly type: "boolean";
+                            readonly description: "是否精确匹配（默认 false）";
+                        };
+                    };
+                    readonly required: readonly ["alt"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly title: "TestId 定位";
+                    readonly description: "通过 data-testid 属性定位";
+                    readonly properties: {
+                        readonly testId: {
+                            readonly type: "string";
+                            readonly description: "data-testid 值";
+                        };
+                    };
+                    readonly required: readonly ["testId"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly title: "CSS 选择器定位";
+                    readonly description: "通过 CSS 选择器定位";
+                    readonly properties: {
+                        readonly css: {
+                            readonly type: "string";
+                            readonly description: "CSS 选择器";
+                        };
+                    };
+                    readonly required: readonly ["css"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly title: "XPath 定位";
+                    readonly description: "通过 XPath 表达式定位";
+                    readonly properties: {
+                        readonly xpath: {
+                            readonly type: "string";
+                            readonly description: "XPath 表达式";
+                        };
+                    };
+                    readonly required: readonly ["xpath"];
+                    readonly additionalProperties: false;
+                }, {
+                    readonly type: "object";
+                    readonly title: "坐标定位";
+                    readonly description: "通过页面坐标定位";
+                    readonly properties: {
+                        readonly x: {
+                            readonly type: "number";
+                            readonly description: "X 坐标（像素）";
+                        };
+                        readonly y: {
+                            readonly type: "number";
+                            readonly description: "Y 坐标（像素）";
+                        };
+                    };
+                    readonly required: readonly ["x", "y"];
+                    readonly additionalProperties: false;
+                }];
+            };
+            attribute: {
+                type: string;
+                description: string;
+            };
+            fullPage: {
+                type: string;
+                description: string;
+            };
+            selector: {
+                type: string;
+                description: string;
+            };
+            output: {
+                type: string;
+                description: string;
+            };
+            timeout: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * extract 工具处理器
+ */
+export declare function handleExtract(params: unknown): Promise<{
+    content: Array<{
+        type: 'text' | 'image';
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=extract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/tools/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCjC,CAAA;AAiBD;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1D,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC,CA2MD"}

package/dist/tools/extract.js

@@ -0,0 +1,304 @@
+/**
+ * extract 工具
+ *
+ * 提取页面内容：
+ * - text: 文本内容
+ * - html: HTML 源码
+ * - attribute: 元素属性
+ * - screenshot: 截图
+ * - state: 页面状态（精简的可交互元素列表）
+ */
+import { writeFile } from 'fs/promises';
+import { z } from 'zod';
+import { formatErrorResponse, getSession } from '../core/index.js';
+import { targetJsonSchema, targetZodSchema } from './schema.js';
+/**
+ * extract 工具定义
+ */
+export const extractToolDefinition = {
+    name: 'extract',
+    description: '提取页面内容：文本、HTML、属性、截图、状态',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            type: {
+                type: 'string',
+                enum: ['text', 'html', 'attribute', 'screenshot', 'state'],
+                description: '提取类型',
+            },
+            target: {
+                ...targetJsonSchema,
+                description: '目标元素（attribute 必填；text/html 可选，省略则提取整个页面；screenshot/state 不需要）',
+            },
+            attribute: {
+                type: 'string',
+                description: '属性名（attribute）',
+            },
+            fullPage: {
+                type: 'boolean',
+                description: '是否全页面截图（screenshot）',
+            },
+            selector: {
+                type: 'string',
+                description: '限制范围（state）',
+            },
+            output: {
+                type: 'string',
+                description: '输出文件路径（可选）。若指定，结果写入文件；否则返回内容',
+            },
+            timeout: {
+                type: 'number',
+                description: '等待目标元素超时',
+            },
+        },
+        required: ['type'],
+    },
+};
+/**
+ * extract 参数 schema
+ */
+const extractSchema = z.object({
+    type: z.enum(['text', 'html', 'attribute', 'screenshot', 'state']),
+    target: targetZodSchema.optional(),
+    attribute: z.string().optional(),
+    fullPage: z.boolean().optional(),
+    selector: z.string().optional(),
+    output: z.string().optional(),
+    timeout: z.number().optional(),
+});
+/**
+ * extract 工具处理器
+ */
+export async function handleExtract(params) {
+    try {
+        const args = extractSchema.parse(params);
+        const session = getSession();
+        switch (args.type) {
+            case 'text': {
+                const text = await extractText(session, args.target);
+                if (args.output) {
+                    await writeFile(args.output, text, 'utf-8');
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: true,
+                                    type: 'text',
+                                    output: args.output,
+                                    size: text.length,
+                                }),
+                            },
+                        ],
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                type: 'text',
+                                content: text,
+                            }),
+                        },
+                    ],
+                };
+            }
+            case 'html': {
+                const html = await extractHTML(session, args.target);
+                if (args.output) {
+                    await writeFile(args.output, html, 'utf-8');
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: true,
+                                    type: 'html',
+                                    output: args.output,
+                                    size: html.length,
+                                }),
+                            },
+                        ],
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                type: 'html',
+                                content: html,
+                            }),
+                        },
+                    ],
+                };
+            }
+            case 'attribute': {
+                if (!args.target) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        code: 'INVALID_ARGUMENT',
+                                        message: 'attribute 提取需要 target 参数',
+                                    },
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                if (!args.attribute) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: {
+                                        code: 'INVALID_ARGUMENT',
+                                        message: 'attribute 提取需要 attribute 参数',
+                                    },
+                                }),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const value = await extractAttribute(session, args.target, args.attribute);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                type: 'attribute',
+                                attribute: args.attribute,
+                                value,
+                            }),
+                        },
+                    ],
+                };
+            }
+            case 'screenshot': {
+                const base64 = await session.screenshot(args.fullPage ?? false);
+                if (args.output) {
+                    // 写入文件
+                    await writeFile(args.output, Buffer.from(base64, 'base64'));
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: true,
+                                    type: 'screenshot',
+                                    output: args.output,
+                                }),
+                            },
+                        ],
+                    };
+                }
+                // 返回 base64 图片
+                return {
+                    content: [
+                        {
+                            type: 'image',
+                            data: base64,
+                            mimeType: 'image/png',
+                        },
+                    ],
+                };
+            }
+            case 'state': {
+                const state = await session.getPageState();
+                if (args.output) {
+                    await writeFile(args.output, JSON.stringify(state, null, 2), 'utf-8');
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: true,
+                                    type: 'state',
+                                    output: args.output,
+                                }),
+                            },
+                        ],
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: true,
+                                type: 'state',
+                                state,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: {
+                                    code: 'INVALID_ARGUMENT',
+                                    message: `未知提取类型: ${args.type}`,
+                                },
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        return formatErrorResponse(error);
+    }
+}
+/**
+ * 提取文本内容
+ */
+async function extractText(session, target) {
+    if (target) {
+        // 定位元素并提取文本
+        const locator = session.createLocator(target);
+        const text = await locator.evaluateOn(`function() {
+      return this.textContent ?? '';
+    }`);
+        return text ?? '';
+    }
+    // 提取整个页面文本
+    return session.evaluate('document.body.innerText');
+}
+/**
+ * 提取 HTML
+ */
+async function extractHTML(session, target) {
+    if (target) {
+        const locator = session.createLocator(target);
+        const html = await locator.evaluateOn(`function() {
+      return this.outerHTML;
+    }`);
+        return html;
+    }
+    return session.evaluate('document.documentElement.outerHTML');
+}
+/**
+ * 提取属性
+ */
+async function extractAttribute(session, target, attribute) {
+    const locator = session.createLocator(target);
+    return locator.evaluateOn(`function() {
+    return this.getAttribute('${attribute}');
+  }`);
+}
+//# sourceMappingURL=extract.js.map