@attson/atwebpilot-mcp 0.0.28 → 0.0.30

package/dist/index.js

@@ -638,6 +638,8 @@ function capabilityForTool(tool, opts) {
       return opts?.httpCookied ? "httpRequest:cookied" : "httpRequest:no-cookie";
     case "askUser":
       return "read:dom";
+    case "screenshot":
+      return "read:image";
     default: {
       const _exhaustive = tool;
       throw new Error(`capabilityForTool: unknown tool ${_exhaustive}`);
@@ -1339,6 +1341,20 @@ var TOOL_DEFS = [
       required: ["tabId"]
     }
   },
+  {
+    name: "screenshot",
+    description: "\u622A\u5F53\u524D tab \u7684\u53EF\u89C1\u533A\u57DF\u4E3A PNG\uFF08base64 \u8FD4\u56DE\uFF0C\u81EA\u52A8\u4F5C\u4E3A image block \u6CE8\u5165\u5230\u4E0B\u8F6E\u4E0A\u4E0B\u6587\uFF09\u3002\u7528\u4E8E\uFF1A\u89C6\u89C9\u8C03\u8BD5 selector\u3001\u770B\u56FE\u56DE\u7B54\u5E03\u5C40\u95EE\u9898\u3001\u4FDD\u5B58\u8BC1\u636E\u3002\u8FD4\u56DE {ok: true, byteLen}\u3002",
+    input_schema: {
+      type: "object",
+      properties: {
+        selector: {
+          type: "string",
+          description: "\u53EF\u9009\uFF1ACSS selector\u3002\u57FA\u7840\u7248\u65E0\u89C6\u5B83\uFF0C\u59CB\u7EC8\u622A viewport\uFF1B\u4FDD\u7559\u5B57\u6BB5\u4E3A\u672A\u6765\u6269\u5C55\u3002"
+        },
+        tabId: { type: "integer", description: "\u76EE\u6807 tab\uFF1B\u7701\u7565 = \u672C\u4F1A\u8BDD tab" }
+      }
+    }
+  },
   {
     name: "askUser",
     description: "\u5411\u7528\u6237\u4E3B\u52A8\u5F81\u8BE2\uFF08\u4E0D\u662F\u6267\u884C\u64CD\u4F5C\uFF09\u3002\u5F53\u4EFB\u52A1\u6709\u591A\u4E2A\u5019\u9009\u3001\u9700\u8981\u4E8C\u6B21\u786E\u8BA4\u3001\u6216\u7F3A\u5173\u952E\u4FE1\u606F\u65F6\u8C03\u7528\u3002\u8FD4\u56DE {choice} \u6216 {value} \u6216 {cancelled:true}\u3002\u4EC5\u5728\u4F60\u786E\u5B9E\u5361\u4F4F\u65F6\u624D\u7528\u2014\u2014\u522B\u7528\u5B83\u505A\u95F2\u804A\u3002",
@@ -1454,11 +1470,53 @@ async function handleBrowserTool(deps, gen, args) {
   return result.return ?? null;
 }
 
+// src/skill-bundle.ts
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var SKILL_NAME = "atwebpilot-browser";
+var SKILL_DESCRIPTION = "Strategy + scenarios + safety rails for driving the AtWebPilot browser extension via MCP.";
+var cached = null;
+function locateSkillFile() {
+  let here = dirname(fileURLToPath(import.meta.url));
+  for (let i = 0; i < 6; i++) {
+    const candidate = join(here, "skill", "SKILL.md");
+    try {
+      readFileSync(candidate, "utf-8");
+      return candidate;
+    } catch {
+    }
+    here = dirname(here);
+  }
+  return join(dirname(fileURLToPath(import.meta.url)), "../../../skill/SKILL.md");
+}
+function readSkillBundle() {
+  if (cached == null) {
+    try {
+      cached = readFileSync(locateSkillFile(), "utf-8");
+    } catch {
+      cached = `# ${SKILL_NAME}
+
+${SKILL_DESCRIPTION}
+
+(Skill bundle not found at build time; see https://github.com/attson/atwebpilot)
+`;
+    }
+  }
+  return { name: SKILL_NAME, description: SKILL_DESCRIPTION, content: cached };
+}
+var SKILL_TOOL = {
+  name: "atwebpilot_skill_read",
+  description: "Return the `atwebpilot-browser` skill bundle \u2014 a recommended tool-usage flow, scenarios, and safety rails for driving AtWebPilot's browser tools.",
+  inputSchema: { type: "object", properties: {}, required: [] }
+};
+
 // src/mcp-server.ts
 var BROWSER_TOOLS = generateBrowserTools();
 var BROWSER_BY_NAME = new Map(BROWSER_TOOLS.map((t) => [t.name, t]));
 function buildToolList() {
   return [
+    { name: SKILL_TOOL.name, description: SKILL_TOOL.description, inputSchema: SKILL_TOOL.inputSchema },
     ...CONTROL_TOOLS.map((t) => ({ name: t.name, description: t.description, inputSchema: t.inputSchema })),
     ...BROWSER_TOOLS.map((t) => ({ name: t.name, description: t.description, inputSchema: t.inputSchema }))
   ];
@@ -1467,6 +1525,10 @@ var ok = (data) => ({ content: [{ type: "text", text: JSON.stringify(data ?? nul
 var fail2 = (message) => ({ content: [{ type: "text", text: message }], isError: true });
 async function dispatchCall(deps, name, args) {
   try {
+    if (name === SKILL_TOOL.name) {
+      const bundle = readSkillBundle();
+      return { content: [{ type: "text", text: bundle.content }] };
+    }
     if (name === "list_tabs") return ok(handleListTabs(deps));
     if (name === "open_session") return ok(handleOpenSession(deps, args));
     if (name === "close_session") return ok(handleCloseSession(deps, args));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attson/atwebpilot-mcp",
-  "version": "0.0.28",
+  "version": "0.0.30",
   "license": "Apache-2.0",
   "description": "MCP server for the atwebpilot browser extension — let Claude Code drive your browser.",
   "homepage": "https://github.com/attson/atwebpilot#readme",