Safari Screenshot

Safari Screenshot

site icon
2025.02.07 0
TypeScript网页截图自动化测试响应式设计浏览器自动化
mcp-safari-screenshot 是一个基于 Node.js 的 MCP 服务,专门用于在 macOS 上通过 Safari 浏览器捕获网页截图。该服务提供了多种配置选项,包括窗口大小、缩放级别、页面加载等待时间等,适用于网页开发、响应式设计测试和质量保证等多种场景。
View on GitHub

Overview

基本能力

产品定位

mcp-safari-screenshot 是一个专为 macOS 设计的网页截图工具,利用 Safari 浏览器提供高质量的截图功能,主要用于网页开发和测试。

核心功能

  • 捕获特定大小的窗口截图
  • 支持不同的缩放级别
  • 可配置的页面加载等待时间
  • 捕获后自动清理
  • 原生 macOS 截图质量

适用场景

  • 网页开发和测试
  • 响应式设计验证
  • 网页质量保证
  • 自动化测试流程

工具列表

  • takeScreenshot: 捕获网页截图,支持多种配置参数如 URL、输出路径、窗口大小、等待时间和缩放级别。

常见问题解答

  1. 权限问题: 确保 Terminal 或 IDE 已添加到 macOS 的 Accessibility 权限列表中。
  2. Safari 模式: 确保 Safari 不在隐私浏览模式下运行。
  3. 工作目录: 确保当前工作目录可写。
  4. 错误消息: 检查 Cursor 的控制台以获取错误消息。

使用教程

使用依赖

  • macOS
  • Safari
  • Node.js >= 14.0.0
  • Terminal 需要 Accessibility 权限(系统偏好设置 → 安全性与隐私 → 隐私 → 辅助功能)

安装教程

npm install safari-screenshot

调试方式

# 测试发现功能
echo '{"type":"discover"}' | npx -y ./server.js

# 测试截图功能
echo '{"type":"execute","tool":"take_screenshot","input":"Take a screenshot of https://apple.com","requestId":"123"}' | npx -y ./server.js

标签信息

安装类型

command

产品定位

  • 网页截图
  • 自动化测试
  • 响应式设计

归类信息

浏览器自动化

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。