@pyrokine/mcp-chrome 1.0.0

package/dist/tools/schema.d.ts

@@ -0,0 +1,261 @@
+/**
+ * 公共 JSON Schema 定义
+ *
+ * 用于 MCP 工具的 inputSchema，确保客户端侧的类型提示和契约校验
+ */
+import { z } from 'zod';
+/**
+ * Target Zod Schema（运行时校验）
+ *
+ * 支持的定位方式：
+ * - role/name: 可访问性树定位
+ * - text: 文本内容定位
+ * - label: 表单 label 定位
+ * - placeholder: 输入框占位符定位
+ * - title: title 属性定位
+ * - alt: alt 属性定位
+ * - testId: data-testid 定位
+ * - css: CSS 选择器定位
+ * - xpath: XPath 定位
+ * - x/y: 坐标定位
+ */
+export declare const targetZodSchema: z.ZodUnion<[z.ZodObject<{
+    role: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    role: string;
+    name?: string | undefined;
+}, {
+    role: string;
+    name?: string | undefined;
+}>, z.ZodObject<{
+    text: z.ZodString;
+    exact: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    exact?: boolean | undefined;
+}, {
+    text: string;
+    exact?: boolean | undefined;
+}>, z.ZodObject<{
+    label: z.ZodString;
+    exact: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    exact?: boolean | undefined;
+}, {
+    label: string;
+    exact?: boolean | undefined;
+}>, z.ZodObject<{
+    placeholder: z.ZodString;
+    exact: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    placeholder: string;
+    exact?: boolean | undefined;
+}, {
+    placeholder: string;
+    exact?: boolean | undefined;
+}>, z.ZodObject<{
+    title: z.ZodString;
+    exact: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    exact?: boolean | undefined;
+}, {
+    title: string;
+    exact?: boolean | undefined;
+}>, z.ZodObject<{
+    alt: z.ZodString;
+    exact: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    alt: string;
+    exact?: boolean | undefined;
+}, {
+    alt: string;
+    exact?: boolean | undefined;
+}>, z.ZodObject<{
+    testId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    testId: string;
+}, {
+    testId: string;
+}>, z.ZodObject<{
+    css: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    css: string;
+}, {
+    css: string;
+}>, z.ZodObject<{
+    xpath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    xpath: string;
+}, {
+    xpath: string;
+}>, z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    x: number;
+    y: number;
+}, {
+    x: number;
+    y: number;
+}>]>;
+/**
+ * Target JSON Schema（MCP 契约）
+ *
+ * 使用 oneOf 表示互斥的定位方式，客户端可根据此生成参数提示
+ */
+export declare const targetJsonSchema: {
+    readonly 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;
+    }];
+    readonly description: "目标元素定位方式";
+};
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/tools/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAA;AAErB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWa,CAAA;AAEzC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GnB,CAAA"}

package/dist/tools/schema.js

@@ -0,0 +1,151 @@
+/**
+ * 公共 JSON Schema 定义
+ *
+ * 用于 MCP 工具的 inputSchema，确保客户端侧的类型提示和契约校验
+ */
+import { z } from 'zod';
+/**
+ * Target Zod Schema（运行时校验）
+ *
+ * 支持的定位方式：
+ * - role/name: 可访问性树定位
+ * - text: 文本内容定位
+ * - label: 表单 label 定位
+ * - placeholder: 输入框占位符定位
+ * - title: title 属性定位
+ * - alt: alt 属性定位
+ * - testId: data-testid 定位
+ * - css: CSS 选择器定位
+ * - xpath: XPath 定位
+ * - x/y: 坐标定位
+ */
+export const targetZodSchema = z.union([
+    z.object({ role: z.string(), name: z.string().optional() }),
+    z.object({ text: z.string(), exact: z.boolean().optional() }),
+    z.object({ label: z.string(), exact: z.boolean().optional() }),
+    z.object({ placeholder: z.string(), exact: z.boolean().optional() }),
+    z.object({ title: z.string(), exact: z.boolean().optional() }),
+    z.object({ alt: z.string(), exact: z.boolean().optional() }),
+    z.object({ testId: z.string() }),
+    z.object({ css: z.string() }),
+    z.object({ xpath: z.string() }),
+    z.object({ x: z.number(), y: z.number() }),
+]);
+/**
+ * Target JSON Schema（MCP 契约）
+ *
+ * 使用 oneOf 表示互斥的定位方式，客户端可根据此生成参数提示
+ */
+export const targetJsonSchema = {
+    oneOf: [
+        {
+            type: 'object',
+            title: '可访问性树定位',
+            description: '通过 ARIA role 和 name 定位元素',
+            properties: {
+                role: { type: 'string', description: 'ARIA role（如 button、link、textbox）' },
+                name: { type: 'string', description: '可访问名称（可选）' },
+            },
+            required: ['role'],
+            additionalProperties: false,
+        },
+        {
+            type: 'object',
+            title: '文本内容定位',
+            description: '通过元素文本内容定位',
+            properties: {
+                text: { type: 'string', description: '文本内容' },
+                exact: { type: 'boolean', description: '是否精确匹配（默认 false）' },
+            },
+            required: ['text'],
+            additionalProperties: false,
+        },
+        {
+            type: 'object',
+            title: 'Label 定位',
+            description: '通过表单 label 文本定位关联的输入元素',
+            properties: {
+                label: { type: 'string', description: 'label 文本' },
+                exact: { type: 'boolean', description: '是否精确匹配（默认 false）' },
+            },
+            required: ['label'],
+            additionalProperties: false,
+        },
+        {
+            type: 'object',
+            title: 'Placeholder 定位',
+            description: '通过输入框的 placeholder 属性定位',
+            properties: {
+                placeholder: { type: 'string', description: 'placeholder 文本' },
+                exact: { type: 'boolean', description: '是否精确匹配（默认 false）' },
+            },
+            required: ['placeholder'],
+            additionalProperties: false,
+        },
+        {
+            type: 'object',
+            title: 'Title 属性定位',
+            description: '通过元素的 title 属性定位',
+            properties: {
+                title: { type: 'string', description: 'title 属性值' },
+                exact: { type: 'boolean', description: '是否精确匹配（默认 false）' },
+            },
+            required: ['title'],
+            additionalProperties: false,
+        },
+        {
+            type: 'object',
+            title: 'Alt 属性定位',
+            description: '通过图片的 alt 属性定位',
+            properties: {
+                alt: { type: 'string', description: 'alt 属性值' },
+                exact: { type: 'boolean', description: '是否精确匹配（默认 false）' },
+            },
+            required: ['alt'],
+            additionalProperties: false,
+        },
+        {
+            type: 'object',
+            title: 'TestId 定位',
+            description: '通过 data-testid 属性定位',
+            properties: {
+                testId: { type: 'string', description: 'data-testid 值' },
+            },
+            required: ['testId'],
+            additionalProperties: false,
+        },
+        {
+            type: 'object',
+            title: 'CSS 选择器定位',
+            description: '通过 CSS 选择器定位',
+            properties: {
+                css: { type: 'string', description: 'CSS 选择器' },
+            },
+            required: ['css'],
+            additionalProperties: false,
+        },
+        {
+            type: 'object',
+            title: 'XPath 定位',
+            description: '通过 XPath 表达式定位',
+            properties: {
+                xpath: { type: 'string', description: 'XPath 表达式' },
+            },
+            required: ['xpath'],
+            additionalProperties: false,
+        },
+        {
+            type: 'object',
+            title: '坐标定位',
+            description: '通过页面坐标定位',
+            properties: {
+                x: { type: 'number', description: 'X 坐标（像素）' },
+                y: { type: 'number', description: 'Y 坐标（像素）' },
+            },
+            required: ['x', 'y'],
+            additionalProperties: false,
+        },
+    ],
+    description: '目标元素定位方式',
+};
+//# sourceMappingURL=schema.js.map

package/dist/tools/schema.js.map

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

package/dist/tools/wait.d.ts

@@ -0,0 +1,203 @@
+/**
+ * wait 工具
+ *
+ * 等待条件：
+ * - element: 等待元素出现/消失/可见/隐藏
+ * - navigation: 等待导航完成
+ * - time: 固定等待时间
+ * - idle: 等待网络空闲
+ */
+/**
+ * wait 工具定义
+ */
+export declare const waitToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            for: {
+                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;
+                }];
+            };
+            state: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            ms: {
+                type: string;
+                description: string;
+            };
+            timeout: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * wait 工具处理器
+ */
+export declare function handleWait(params: unknown): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=wait.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/tools/wait.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B9B,CAAA;AAeD;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IACvD,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,CA8HD"}