hookdeck/hookdeck-cli

解决的问题

Hookdeck CLI 允许开发者将外部服务的 Webhook 和其他事件转发到本地 Web 服务器，用于测试和开发。它通过提供永久事件 URL，并支持在会话间保存、检查和重放事件历史，消除了复杂隧道设置的需求。

工作原理

CLI 在 Hookdeck 事件网关与本地端口或 URL 之间建立连接。当外部服务向 Hookdeck 事件 URL 发送事件时，CLI 会将该事件转发到指定的本地端点。它包含一个终端用户界面（TUI），用于实时检查、过滤和重放请求。

适用人群

需要使用实时 Webhook 触发本地代码的开发者，例如构建与 Shopify、Stripe 或 GitHub 等第三方 API 的集成。

主要特性

• 永久事件 URL：提供稳定的 URL 用于接收事件，无需为每次会话重新创建。
• 交互式 TUI：全屏终端界面，可直接从命令行导航、检查和重试事件。
• 事件管理：可查看、重放和书签事件，历史记录在会话间保持持久化。
• AI 代理集成：包含一个事件网关 MCP 服务器（hookdeck gateway mcp），允许 AI 代理（如 Cursor、Claude）将网关资源作为工具进行管理。
• 灵活的过滤功能：支持使用 JSON 语法按正文、头信息、查询参数或路径过滤事件，以在开发过程中减少噪音。