take_screenshot
Capture high-quality webpage screenshots using Safari on macOS. Specify URL, dimensions, zoom level, and save path. Automates page load wait time for accurate results.
Instructions
Take a screenshot of a webpage using Safari on macOS
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| height | No | Window height in pixels (default: 768) | |
| outputPath | No | Path where the screenshot will be saved (default: ./screenshots/[hostname]-[timestamp].png) | |
| url | Yes | URL to capture | |
| waitTime | No | Time to wait for page load in seconds (default: 3) | |
| width | No | Window width in pixels (default: 1024) | |
| zoomLevel | No | Zoom level (1 = 100%, 0.5 = 50%, 2 = 200%) |
Implementation Reference
- src/screenshot.ts:23-65 (handler)The primary handler function that implements the screenshot capture logic using Safari and macOS screencapture tool.export async function takeScreenshot(options: ScreenshotOptions): Promise<ScreenshotResult> { const { url, outputPath, width = 1024, height = 768, waitTime = 3, zoomLevel = 1 } = options; try { // Create screenshots directory if it doesn't exist const dir = path.dirname(outputPath); await fs.mkdir(dir, { recursive: true }); // Open URL in Safari await execAsync(`open -a Safari "${url}"`); // Wait for page load await new Promise((resolve) => setTimeout(resolve, waitTime * 1000)); // Take screenshot using screencapture const command = [ 'screencapture', '-x', // Disable interactive mode width && height ? `-R 0,0,${width},${height}` : '', // Set window size outputPath, ] .filter(Boolean) .join(' '); await execAsync(command); // Verify screenshot was created const stats = await fs.stat(outputPath); if (stats.size < 1000) { throw new Error('Screenshot appears to be empty or too small'); } return { success: true, path: outputPath, }; } catch (error) { throw error instanceof Error ? error : new Error(String(error)); } finally { // Clean up Safari windows await execAsync('osascript -e \'tell application "Safari" to close every window\'').catch(() => {}); } }
- src/index.ts:49-83 (schema)JSON Schema for input validation of the take_screenshot tool parameters.inputSchema: { type: 'object', properties: { url: { type: 'string', description: 'URL to capture', }, outputPath: { type: 'string', description: 'Path where the screenshot will be saved (default: ./screenshots/[hostname]-[timestamp].png)', default: '', }, width: { type: 'number', description: 'Window width in pixels (default: 1024)', default: 1024, }, height: { type: 'number', description: 'Window height in pixels (default: 768)', default: 768, }, waitTime: { type: 'number', description: 'Time to wait for page load in seconds (default: 3)', default: 3, }, zoomLevel: { type: 'number', description: 'Zoom level (1 = 100%, 0.5 = 50%, 2 = 200%)', default: 1, }, }, required: ['url'], },
- src/index.ts:95-97 (registration)Registration of the take_screenshot tool in the MCP server capabilities.tools: { take_screenshot: SCREENSHOT_TOOL, },
- src/index.ts:103-105 (registration)Handler for listing available tools, including take_screenshot.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [SCREENSHOT_TOOL], }));
- src/index.ts:116-138 (handler)Tool dispatch handler case that validates arguments and calls the takeScreenshot function.case 'take_screenshot': { if (!isScreenshotArgs(args)) { throw new Error('Invalid arguments for take_screenshot'); } const outputPath = args.outputPath || `./screenshots/${new URL(args.url).hostname}-${Date.now()}.png`; const result = await takeScreenshot({ url: args.url, outputPath, width: args.width, height: args.height, waitTime: args.waitTime, zoomLevel: args.zoomLevel, }); return { content: [ { type: 'text', text: `Screenshot saved to: ${result.path}`, }, ], isError: false, }; }