hookdeck-cli

概述

Hookdeck CLI 主要是一个强大的工具，用于将 webhook 转发到本地主机，提供无限免费和永久的 event URL，作为 ngrok 的替代品。它全面管理 Hookdeck 事件网关资源，包括源、连接、目标、事件和转换。CLI 包含一个内置的 MCP 服务器，将这些功能作为工具暴露给 MCP 兼容客户端（如 Cursor 和 Claude），使其特别有价值用于 AI 工作流程。界面设计良好，具有交互式 TUI，显示事件历史，允许重放、过滤和详细检查请求/响应。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• list_sources

  List all event sources in the Hookdeck Event Gateway

  试试:Show me all my webhook sources试试:List all sources in my Hookdeck account
• list_destinations

  List all destinations in the Hookdeck Event Gateway

  试试:Show me all my destinations试试:List all endpoints I can send events to
• list_connections

  List all connections between sources and destinations

  试试:Show me all my connections试试:List how sources are connected to destinations
• create_source

  Create a new event source in Hookdeck

  试试:Create a new GitHub source for my webhook试试:Add a new Stripe source to my account
• create_destination

  Create a new destination for events in Hookdeck

  试试:Create a new destination pointing to localhost:3000试试:Add a webhook endpoint destination
• create_connection

  Create a new connection between a source and destination

  试试:Connect my GitHub source to my localhost destination试试:Create a connection from Shopify to my production API
• update_connection

  Update an existing connection between source and destination

  试试:Update my connection to add filtering rules试试:Modify the path for my GitHub connection
• delete_connection

  Delete an existing connection in Hookdeck

  试试:Remove the connection between my GitHub source and localhost试试:Delete the connection from Shopify to my production API
• list_events

  List events that have been processed through the Event Gateway

  试试:Show me the events from the last hour试试:List all events from my GitHub source
• create_transformation

  Create a new transformation to modify event data

  试试:Create a transformation to add my API key to request headers试试:Set up a transformation to normalize event payloads
• listen_events

  Listen to events from a source or connection

  试试:Listen to events from my Stripe source试试:Forward events from GitHub to my local development server
• replay_event

  Replay a previously processed event

  试试:Replay that failed event to my local server试试:Send that Shopify order event again

可对比工具

安装

# NPM
npm install hookdeck-cli -g

# macOS
brew install hookdeck/hookdeck/hookdeck

# Windows
scoop bucket add hookdeck https://github.com/hookdeck/scoop-hookdeck-cli.git
scoop install hookdeck

# Linux
tar -xvf hookdeck_X.X.X_linux_amd64.tar.gz
./hookdeck

{
  "mcpServers": {
    "hookdeck": {
      "command": "hookdeck",
      "args": ["gateway", "mcp"]
    }
  }
}

FAQ

Hookdeck CLI 和 ngrok 有什么区别？

Hookdeck CLI 提供无限免费永久 URL，在会话之间保留事件历史，支持过滤和扇出传递，并通过 CLI 包含资源管理功能。

MCP 服务器如何与 AI 代理集成？

事件网关 MCP 服务器（`hookdeck gateway mcp`）将 Hookdeck 的 webhook 和事件管理功能作为工具暴露给 MCP 兼容客户端（如 Cursor 和 Claude），允许 AI 代理与您的事件基础设施交互。

hookdeck-cli 对比