@magentaesolutions/device-screenshot-mcp 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { execFile } from 'node:child_process';
+import { readFile, unlink } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+const PMD3 = process.env.PYMOBILEDEVICE3_PATH || 'pymobiledevice3';
+const server = new McpServer({
+    name: 'device-screenshot',
+    version: '1.0.0',
+});
+function exec(cmd, args, timeout = 15000) {
+    return new Promise((resolve, reject) => {
+        execFile(cmd, args, { timeout }, (err, stdout, stderr) => {
+            if (err)
+                reject(new Error(stderr || err.message));
+            else
+                resolve({ stdout, stderr });
+        });
+    });
+}
+server.tool('take_screenshot', 'Take a screenshot from a connected physical iOS device via USB. Returns the image as a PNG. Requires pymobiledevice3 tunneld to be running (sudo pymobiledevice3 remote tunneld).', {}, async () => {
+    const outPath = join(tmpdir(), `device-screenshot-${Date.now()}.png`);
+    try {
+        await exec(PMD3, ['developer', 'dvt', 'screenshot', outPath, '--tunnel', '']);
+        const data = await readFile(outPath);
+        await unlink(outPath).catch(() => { });
+        return {
+            content: [
+                {
+                    type: 'image',
+                    data: data.toString('base64'),
+                    mimeType: 'image/png',
+                },
+            ],
+        };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        if (msg.includes('tunneld') || msg.includes('tunnel')) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Tunneld is not running. Start it with:\n  sudo pymobiledevice3 remote tunneld',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: 'text', text: `Screenshot failed: ${msg}` }],
+            isError: true,
+        };
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@magentaesolutions/device-screenshot-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for taking screenshots from physical iOS devices via USB",
+  "type": "module",
+  "bin": {
+    "device-screenshot-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "ios",
+    "screenshot",
+    "claude",
+    "pymobiledevice3"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.9.3"
+  }
+}