take_screenshot
Capture screenshots of web pages for debugging purposes. Supports viewport or full-page captures and offers flexible output options including file saving or base64 data return.
Instructions
截图工具(辅助调试)。支持视口截图和全页截图。建议在使用前询问用户希望的输出方式:如果用户需要直接查看图片,使用 inline 模式返回 base64;如果用户需要保存图片文件,使用 file 或 auto 模式保存为文件。对于全页截图或大图片,强烈建议使用 file/auto 模式避免响应过大。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | 页面 URL(可选) | |
| fullPage | No | 是否截取整页。true 表示截取整个页面(包括需要滚动才能看到的内容),false 表示只截取当前视口可见部分。全页截图会自动触发懒加载内容,确保完整截图。 | |
| outputMode | No | 输出模式(建议在使用前询问用户偏好): - auto:根据图片大小自动选择(小于阈值返回 base64,大于阈值保存为文件,默认阈值 100KB) - file:始终保存为文件,返回文件路径(适合用户明确需要保存文件的情况) - inline:始终返回 base64 编码的图片数据(适合用户需要直接查看小图片的情况,不推荐用于全页截图,因为会导致响应过大) 选择建议: - 如果用户说"截图"、"保存截图"、"下载截图"等,使用 file 或 auto 模式 - 如果用户说"显示截图"、"查看截图"、"预览截图"等,且图片较小(非全页),可以使用 inline 模式 - 如果用户未明确说明,或进行全页截图,默认使用 auto 模式 - 如果不确定用户需求,建议询问:"您希望截图以什么方式返回?1) 保存为文件(推荐,适合大图片) 2) 直接返回图片数据(仅适合小图片)" | auto |
| filePath | No | 文件保存路径(可选,仅在 file/auto 模式时有效)。如果未指定,默认保存到 ./screenshots/screenshot-{timestamp}-{random}.png。可以使用相对路径(相对于 MCP Server 工作目录)或绝对路径。 | |
| maxBase64SizeKB | No | auto 模式阈值(KB,base64 大小,默认 100KB)。当 auto 模式下,如果图片的 base64 大小超过此阈值,会自动保存为文件;否则返回 base64。 | |
| scrollDelay | No | 滚动后等待时间(毫秒,用于触发懒加载,默认 1000) | |
| waitForSelector | No | 等待特定选择器加载(可选,字符串) |