Cursor Puppeteer MCP

基本能力

产品定位

Cursor Puppeteer MCP 是一个用于浏览器自动化和开发效率的工具，主要用于在开发过程中提供视觉反馈和自动化测试。

核心功能

1. 访问本地开发服务器 URL
2. 检查页面错误
3. 对页面或特定元素进行截图
4. 执行点击、悬停、聚焦、输入等操作
5. 比较截图与预期结果

适用场景

1. 开发过程中自动验证页面渲染效果
2. 自动化测试页面交互
3. 生成页面截图用于文档或演示
4. 迭代改进代码基于视觉反馈

工具列表

1. takeScreenshot：用于截取页面或特定元素的截图
2. deleteScreenshot：用于删除已保存的截图

常见问题解答

1. 如何指定等待时间？：通过 waitTime 参数指定等待时间（毫秒）
2. 如何执行点击操作？：通过 action 参数指定元素和操作类型
3. 如何截取特定元素？：通过 elementToCapture 参数指定元素

使用教程

使用依赖

安装 Node.js 和 npm

安装教程

npm install

调试方式

1. 从命令行运行工具：

node src/cursor-integration.js http://localhost:3000 '{"waitTime": 1000}'

1. 在 Cursor 中集成使用：

import { takeScreenshot } from "./src/cursor-client.js";
const result = await takeScreenshot("http://localhost:3000", {
  waitTime: 1000,
});

许可证

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