mcpField
P
Puppetflow

Puppetflow

远程服务
docs.puppetflow.com浏览器自动化1今天更新

关于 Puppetflow

Puppetflow 是可自托管的平台,用于创建、定时运行和监控 JavaScript 浏览器工作流,面向需要自动化浏览器任务的团队和个人。它支持实时查看会话,并可在需要人工处理时接管。

主要功能

  1. 01创建 JavaScript 浏览器工作流
  2. 02手动或定时运行工作流
  3. 03实时查看会话并接管
  4. 04整理流程和可复用片段
  5. 05查看运行历史、日志和结果

适用场景

  1. 01安排重复性的浏览器任务
  2. 02介入需要人工处理的实时运行
  3. 03检查工作流日志和执行结果

MCP 相关

每个 Puppetflow 实例都通过 Streamable HTTP 提供远程 MCP 服务。MCP 客户端可搜索、查看、创建和运行流程,跟踪运行状态,并获取结果、截图和录屏。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://{instance_host}/api/workspaces/{workspace}/mcp-server/http
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Puppetflow

Puppetflow

Puppetflow 是一个可自托管的浏览器自动化平台,可用于编写、运行、安排和监控 JavaScript 工作流。实时查看浏览器会话,并在运行需要人工介入时随时接管。

GitHub stars Package on GHCR GHCR package version Last commit

⭐️ 喜欢 Puppetflow?给仓库点个星,帮助更多人发现这个项目。

一条命令安装 Puppetflow

curl -fsSL https://puppetflow.com/install.sh | bash

🌐 网站和文档

🎉 功能

  • 使用 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 实战展示

Puppetflow 可视化流程构建器
Puppetflow 运行详情,包含浏览器录制、日志和操作时间线
Puppetflow 与消息、AI、保险库和 Git 提供商的集成
Puppetflow 流程浏览器,展示文件夹和已发布的浏览器自动化流程

🛟 讨论 / 需要帮助?

加入我们的 Discord

加入我们的 Discord

提交 Issue

在 GitHub 上提交 issue

项目理念

Puppetflow 围绕几个简单的理念构建:

  • 浏览器自动化应当易于理解和调试。
  • 自托管应当是真正可行的选择,而非事后才考虑的事项。
  • 良好的默认设置很重要,但用户应当掌控自己的数据和基础设施。
  • 可靠性和可维护性比推出一长串尚未完成的功能更重要。

关于项目历史的说明

出于安全原因,Community Edition 发布时有意重置了公开的 Git 历史记录。因此,此仓库的提交数量并不能反映项目的年限或成熟度。

Puppetflow 已在真实环境中开发和运行近一年。Community Edition 是对现有产品的发布,而不是原型项目的起点。

禁止低质量 AI 生成内容政策

Puppetflow 不接受敷衍且未经审核的生成式代码或内容。

并不禁止 AI 辅助工作,但禁止提交贡献者自己不理解、未经检查或无法维护的产出。贡献必须经过深思熟虑、与现有代码库保持一致,并由提交者本人负责。

实用规则请参阅贡献指南。

仓库文档

许可证

Puppetflow 的源代码可用。大部分代码依据 Puppetflow 源代码可用许可证授权,允许个人非商业用途。企业内部使用需要有效的 Puppetflow 付费订阅或订单。

proprietary/ 下的文件、包含 .pp. 标记的文件,以及明确标记的代码块实现了付费功能。这些内容受 Puppetflow 专有许可证约束,在生产环境中使用需要有效的 Puppetflow 订阅。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。