pup-recorder-mcp 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Autokaka <qq1909698494@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# pup-recorder-mcp(1)
+
+## NAME
+
+pup-recorder-mcp - MCP server for pup(1)
+
+## SYNOPSIS
+
+```
+pup-mcp-server
+```
+
+## DESCRIPTION
+
+Exposes pup(1) as an MCP tool over stdio transport.
+
+## CONFIGURATION
+
+```json
+{
+  "mcpServers": {
+    "pup-recorder": {
+      "command": "npx",
+      "args": ["--yes", "pup-recorder-mcp"]
+    }
+  }
+}
+```
+
+## TOOL
+
+```
+name              pup-recorder
+source            string   file://, http(s)://, or data: URI (required)
+duration          number   seconds, default 5
+width             number   default 1920
+height            number   default 1080
+fps               number   default 30
+withAlphaChannel  boolean  default false
+outDir            string   default "out"
+useInnerProxy     boolean  default false
+```
+
+Returns JSON: `{ mp4?, webm?, mov?, cover, width, height, fps, duration }`.
+
+## SEE ALSO
+
+pup(1), pup(7)
+
+## AUTHOR
+
+qq1909698494@gmail.com

package/bin.ts

@@ -0,0 +1,41 @@
+// Created by Autokaka (qq1909698494@gmail.com) on 2026/02/26.
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { pup, RecordSchema } from "pup-recorder";
+import z from "zod";
+import pkg from "./package.json";
+
+export const PupMCPSchema = z
+  .object({ source: z.string().describe("file://, http(s)://, or data: URI") })
+  .extend(RecordSchema.shape);
+
+async function main() {
+  const server = new McpServer(pkg);
+  server.registerTool(
+    "pup-recorder",
+    {
+      title: "Record Webpage",
+      description: "Record a webpage to video",
+      inputSchema: PupMCPSchema,
+    },
+    async (args) => {
+      try {
+        const result = await pup(args.source, args);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      } catch (error) {
+        return {
+          isError: true,
+          content: [
+            { type: "text", text: JSON.stringify({ error: String(error) }) },
+          ],
+        };
+      }
+    },
+  );
+  await server.connect(new StdioServerTransport());
+}
+
+main();

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "pup-recorder-mcp",
+  "version": "0.0.2",
+  "description": "MCP server for pup-recorder.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Autokaka/pup-recorder-mcp.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "autokaka",
+    "email": "qq1909698494@gmail.com"
+  },
+  "type": "module",
+  "bin": "bin.ts",
+  "engines": {
+    "bun": ">= 1",
+    "node": ">= 20"
+  },
+  "engineStrict": true,
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "latest",
+    "@typescript/native-preview": "latest",
+    "pup-recorder": "workspace:*",
+    "zod": "latest"
+  },
+  "scripts": {
+    "build": "tsgo"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "lib": ["ESNext", "DOM"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "types": ["node"],
+
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noPropertyAccessFromIndexSignature": true
+  },
+  "include": ["bin.ts"]
+}