关于 Puppetflow
Puppetflow 是可自托管的平台,用于创建、定时运行和监控 JavaScript 浏览器工作流,面向需要自动化浏览器任务的团队和个人。它支持实时查看会话,并可在需要人工处理时接管。
主要功能
- 01创建 JavaScript 浏览器工作流
- 02手动或定时运行工作流
- 03实时查看会话并接管
- 04整理流程和可复用片段
- 05查看运行历史、日志和结果
适用场景
- 01安排重复性的浏览器任务
- 02介入需要人工处理的实时运行
- 03检查工作流日志和执行结果
MCP 相关
每个 Puppetflow 实例都通过 Streamable HTTP 提供远程 MCP 服务。MCP 客户端可搜索、查看、创建和运行流程,跟踪运行状态,并获取结果、截图和录屏。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://{instance_host}/api/workspaces/{workspace}/mcp-server/httpclaude mcp add --transport http com-puppetflow https://{instance_host}/api/workspaces/{workspace}/mcp-server/http{"mcpServers":{"com-puppetflow":{"type":"http","url":"https://{instance_host}/api/workspaces/{workspace}/mcp-server/http"}}}在 Cursor 中打开{"servers":{"com-puppetflow":{"type":"http","url":"https://{instance_host}/api/workspaces/{workspace}/mcp-server/http"}}}在 VS Code 中打开{"mcpServers":{"com-puppetflow":{"type":"http","url":"https://{instance_host}/api/workspaces/{workspace}/mcp-server/http"}}}{"mcpServers":{"com-puppetflow":{"serverUrl":"https://{instance_host}/api/workspaces/{workspace}/mcp-server/http"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Puppetflow
Puppetflow 是一个可自托管的浏览器自动化平台,可用于编写、运行、安排和监控 JavaScript 工作流。实时查看浏览器会话,并在运行需要人工介入时随时接管。
⭐️ 喜欢 Puppetflow?给仓库点个星,帮助更多人发现这个项目。
一条命令安装 Puppetflow
curl -fsSL https://puppetflow.com/install.sh | bash
🌐 网站和文档
- 网站:puppetflow.com
- 视频:100 秒了解 Puppetflow
- 文档:docs.puppetflow.com
- 自托管指南:安装或更新 Puppetflow
🎉 功能
- 使用 JavaScript 构建浏览器工作流
- 手动、按计划或通过集成运行工作流
- 实时查看浏览器会话,并在需要时接管
- 在工作区中整理流程和可复用代码片段
- 在作用域限定的媒体库中存储、标记、整理和编辑文本文件,然后在流程输入或
$upload中复用 - 管理变量、密钥和浏览器配置文件
- 查看运行历史、日志和执行结果
- 连接代码仓库和 1Password 等外部密钥库
- 集成消息工具和邮箱
- 使用 Docker 部署到自己的基础设施
- 通过可复用流程和代码片段扩展 Puppetflow
- 通过经过身份验证的 REST API 自动处理媒体库文件和文件夹
🔗 n8n 集成
Puppetflow 提供 n8n-nodes-puppetflow 社区节点,可将浏览器自动化功能添加到 n8n 工作流中。
- 使用可选的 JSON 输入触发流程。
- 列出并监控运行,然后获取其结果。
- 下载屏幕截图、文件和会话录制。
在自托管的 n8n 实例中,通过 Settings > Community Nodes 安装该软件包,然后使用 Puppetflow 实例 URL 和从 Profile > API Keys 获取的 API 密钥进行连接。有关设置详情,请参阅 n8n 集成指南。
🤖 面向 AI 客户端的 MCP 服务
每个 Puppetflow 实例都会通过 Streamable HTTP 提供远程 Model Context Protocol 服务。连接 Cline、Cursor、Claude、Claude Code 或其他 MCP 客户端,即可搜索、检查、创建和运行浏览器自动化流程,跟踪运行并获取结果、屏幕截图和录制内容。
无需在本地运行任何内容。在 Workspace > Settings > Instance MCP 中启用 MCP,创建访问令牌,然后将端点添加到客户端:
{
"mcpServers": {
"puppetflow": {
"type": "streamableHttp",
"url": "https://your-puppetflow.example/api/mcp-server/http",
"headers": {
"Authorization": "Bearer mcp_your_token_here"
}
}
}
}
对于支持远程 MCP OAuth 的客户端,也提供带 PKCE 和动态客户端注册的 OAuth 端点。请参阅 llms-install.md 了解客户端设置步骤,并参阅 MCP 指南 查看完整的工具列表。
Puppetflow 实战展示
🛟 讨论 / 需要帮助?
加入我们的 Discord
提交 Issue
项目理念
Puppetflow 围绕几个简单的理念构建:
- 浏览器自动化应当易于理解和调试。
- 自托管应当是真正可行的选择,而非事后才考虑的事项。
- 良好的默认设置很重要,但用户应当掌控自己的数据和基础设施。
- 可靠性和可维护性比推出一长串尚未完成的功能更重要。
关于项目历史的说明
出于安全原因,Community Edition 发布时有意重置了公开的 Git 历史记录。因此,此仓库的提交数量并不能反映项目的年限或成熟度。
Puppetflow 已在真实环境中开发和运行近一年。Community Edition 是对现有产品的发布,而不是原型项目的起点。
禁止低质量 AI 生成内容政策
Puppetflow 不接受敷衍且未经审核的生成式代码或内容。
并不禁止 AI 辅助工作,但禁止提交贡献者自己不理解、未经检查或无法维护的产出。贡献必须经过深思熟虑、与现有代码库保持一致,并由提交者本人负责。
实用规则请参阅贡献指南。
仓库文档
许可证
Puppetflow 的源代码可用。大部分代码依据 Puppetflow 源代码可用许可证授权,允许个人非商业用途。企业内部使用需要有效的 Puppetflow 付费订阅或订单。
proprietary/ 下的文件、包含 .pp. 标记的文件,以及明确标记的代码块实现了付费功能。这些内容受 Puppetflow 专有许可证约束,在生产环境中使用需要有效的 Puppetflow 订阅。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。


