blinkbox

BlinkBox

开源自动化平台（Zapier / Make / n8n 的替代方案），内置 MCP 服务——连接 Claude Code、Cursor 或 ChatGPT，让 Agent 构建、运行和调试工作流。

blinkbox.net 提供免费托管套餐（无需信用卡） · 使用 Node 22 + MongoDB + Redis 自托管 · MIT。

---

功能介绍

• MCP 服务——整个平台通过 Model Context Protocol（Streamable HTTP）开放。你的编码 Agent 可通过工具调用列出、创建、运行、启用和调试工作流——请参阅在 Claude Code、Cursor 或 ChatGPT 中使用（60 秒）
• Agent 技能——SKILL.md 用于向 Agent 介绍节点字段、表达式语法和执行规则，因此只需约 4 次工具调用即可构建可用流程，而不是靠猜测调用约 12 次
• 拖放画布——Agent 构建的所有内容都是标准工作流，可打开并通过可视化方式编辑
• AI Agent——可对数据进行推理并输出结构化结果的大模型节点
• 无头抓取——完整的 Chromium 池，可绕过反机器人机制并渲染 JavaScript
• 代码沙箱——在具有内存限制的隔离 V8 沙箱中编写 JavaScript
• 250+ 种集成——Gmail、Slack、Stripe、GitHub、Notion、Airtable、Shopify 等
• 加密凭据库——使用 AES-256-GCM；密钥永远不会以解密状态离开服务端

---

在 Claude Code、Cursor 或 ChatGPT 中使用（60 秒）

1. 在 blinkbox.net 注册 → Dashboard → MCP → 创建 API 密钥。

2. 将服务添加到你的客户端：

   # Claude Code
   claude mcp add --transport http blinkbox https://mcp.blinkbox.net/mcp \
     --header "Authorization: Bearer <your key>"
   

   // Cursor / Claude Desktop / any client that takes a JSON config
   {
     "mcpServers": {
       "blinkbox": {
         "url": "https://mcp.blinkbox.net/mcp",
         "headers": { "Authorization": "Bearer <your key>" }
       }
     }
   }
   

   无法发送请求头的客户端可以改为在 URL 中传递密钥：https://mcp.blinkbox.net/mcp?key=<your key>。

3. （推荐）安装技能，让 Agent 了解节点目录和表达式语法：

   mkdir -p ~/.claude/skills/blinkbox && curl -fsSL \
     https://raw.githubusercontent.com/blinkboxhq/Blinkbox/main/.claude/skills/blinkbox/SKILL.md \
     -o ~/.claude/skills/blinkbox/SKILL.md
   

4. 描述你的需求：

   “每天早上 8 点，在 OpenStreetMap 上查找柏林列出网站、电子邮件和电话号码的牙医，与我的 Google Sheet 去重，然后追加新条目。”

   Agent 会调用 create_automation 创建自动化，通过 run_automation 运行，在发生故障时读取 get_execution_logs，运行正常后调用 activate_automation。OAuth 应用（Google、Slack、Notion……）由你在仪表板中连接一次即可——Agent 永远不会看到你的令牌。

工具： list_automations · get_automation · create_automation · run_automation · activate_automation · deactivate_automation · rename_automation · delete_automation · list_executions · get_execution · get_execution_logs · list_nodes · get_node · list_node_actions · list_credentials · create_credential · blinkbox_api_get · blinkbox_api

要自托管？同一服务位于 <your backend>/api/mcp——在你自己的仪表板中创建密钥即可。

---

技术栈

层	技术
前端	React 18 + Vite + Tailwind CSS + ReactFlow
后端	Node.js + Express + MongoDB Atlas + Redis
AI	Anthropic Claude（主要）→ Groq → Gemini（备用）
抓取	Puppeteer + Chromium
执行	基于游标的分布式引擎，包含 4 个工作单元
部署	Railway（nixpacks）

---

本地设置

前提条件

• Node.js ≥ 22
• MongoDB Atlas 集群（或本地 MongoDB）
• Redis（本地或 Upstash）

1. 克隆

git clone https://github.com/blinkboxhq/Blinkbox.git
cd Blinkbox
npm install

2. 配置环境

cp apps/backend/.env.example apps/backend/.env

编辑 apps/backend/.env——至少需要配置：

MONGODB_URI=mongodb+srv://...
REDIS_URL=redis://localhost:6379
JWT_SECRET=your-32-char-secret
ENCRYPTION_KEY=your-exactly-32-char-key
ANTHROPIC_API_KEY=sk-ant-...          # enables the AI workflow builder behind create_automation

3. 运行

# Terminal 1 — backend (port 3000)
cd apps/backend && npm run dev

# Terminal 2 — frontend (port 5174)
cd apps/frontend && npm run dev

打开 http://localhost:5174。

---

环境变量

必需项

变量	说明
MONGODB_URI	MongoDB 连接字符串
REDIS_URL	Redis 连接字符串
JWT_SECRET	至少 32 个字符，可以是任意随机字符串
ENCRYPTION_KEY	必须正好 32 个字符——用于凭据库的 AES 加密

AI（建议至少配置一项）

Variable	Description
ANTHROPIC_API_KEY	启用 AI 工作流构建器（Claude），供 create_automation MCP 工具使用
GROQ_API_KEY	备用大模型（Llama 3.3 70B）
GOOGLE_AI_KEY	备用大模型（Gemini 2.0 Flash）

OAuth 集成（可选）

Variable	Description
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET	Gmail、Drive、Calendar OAuth
SLACK_CLIENT_ID / SLACK_CLIENT_SECRET	Slack OAuth
GITHUB_CLIENT_ID / GITHUB_CLIENT_SECRET	GitHub OAuth
MICROSOFT_CLIENT_ID / MICROSOFT_CLIENT_SECRET	Microsoft 365 OAuth
NOTION_CLIENT_ID / NOTION_CLIENT_SECRET	Notion OAuth
AIRTABLE_CLIENT_ID / AIRTABLE_CLIENT_SECRET	Airtable OAuth

部署

Variable	Description
BACKEND_PUBLIC_URL	面向公众的后端 URL（例如 https://api.blinkbox.net）——OAuth 回调必需
FRONTEND_URL	用于 CORS 允许列表的前端 URL
PORT	后端端口（默认：3000）

---

架构

┌─────────────────────────────────────────────────────┐
│                    Frontend (Vite)                  │
│  Dashboard · Workspace Canvas · MCP keys            │
└───────────────────────┬─────────────────────────────┘
                        │ REST API
┌───────────────────────▼─────────────────────────────┐
│                Backend (Express)                    │
│  Auth · Automations · Executions · Credentials      │
│  MCP server · AI builder · OAuth · Webhooks         │
└──────────┬──────────────────┬───────────────────────┘
           │                  │
    ┌──────▼──────┐    ┌──────▼──────┐
    │  MongoDB    │    │    Redis    │
    │  Atlas      │    │   Queues   │
    └─────────────┘    └──────┬──────┘
                              │
                    ┌─────────▼───────────┐
                    │  Execution Workers  │
                    │  (4 cursor cells)   │
                    │  Chromium pool      │
                    └─────────────────────┘

执行引擎

工作流以基于游标的状态机运行。每次执行都是一个带有游标数组的 MongoDB 文档。Worker 通过 arrayFilters 原子地认领游标、运行节点处理程序、推进游标并释放。Redis 队列将触发器扇出与执行解耦。恢复进程每 5 秒恢复一次崩溃的执行。

节点系统

每种集成都由一个节点实现，包含两部分：

• 前端（nodeRegistry.js）——配置面板、图标、标签、类别
• 后端（nodes/）——无状态处理程序 async (config, context) => result

两端通过相同的 backendType 键关联。已注册 250 多个节点。

---

AI 工作流构建器

create_automation（MCP 工具）会将你的描述交给服务端构建器：

“当有新的 Stripe 付款时，在 HubSpot 中查找客户，并向 #revenue 发送 Slack 提醒”

构建器会结合节点知识库调用 Claude，并强制使用工具，返回一个配置完整、画布布局正确的工作流——包含真实字段值、变量串联（{{trigger.data.from}}）和节点位置——作为草稿，你可以通过 Agent 或 UI 运行、检查并启用该草稿。

**提供商回退链：**Anthropic → Groq → Gemini

---

安全

• 所有 API 路由均采用 JWT 身份验证，查询按工作区隔离
• 使用 AES-256-GCM 加密凭据（密钥从不存储在数据库中）
• 对所有出站 HTTP 请求进行 SSRF 防护
• 代码沙箱：隔离的 V8 环境，并设有内存和时间限制（isolated-vm）
• Shell 工具节点受 ENABLE_SHELL_TOOLS=true 控制（默认关闭）
• OAuth 状态令牌（CSRF 防护），仅向明确指定的源发送 postMessage
• 对 Webhook 触发器进行速率限制（由 Redis 支持，重启后仍有效）

---

在 Railway 上部署

1. 创建 Railway 项目并添加代码仓库
2. 在 Railway 控制面板中设置所有必需的环境变量
3. 将 BACKEND_PUBLIC_URL 设置为 Railway 后端 URL
4. 如果使用 Gmail，请在 Google Cloud Console 中将该 URL 注册为 OAuth 重定向 URI

apps/backend/ 中的 nixpacks.toml 会自动安装 Chromium 和所有原生依赖。

---

许可证

MIT