Zhook Mcp Server

@zhook/mcp-server

适用于 zhook 的官方 Model Context Protocol (MCP) 服务，让 AI Agent 能够与您的 Zhook Webhook、事件和指标进行交互。

功能

• 创建 Hook：直接通过您的 Agent 创建新的 Webhook 或 MQTT Hook。
• 列出 Hook：获取已配置 Webhook 的列表。
• 检查事件：查看特定 Hook 的近期事件。
• 等待事件：暂停执行并等待特定事件发生。
• 指标：查看有关 Webhook 性能的详细指标。

安装

您可以使用 npx 运行此服务，或全局安装。

使用 npx（推荐用于 Claude Desktop）

将以下内容添加到您的 MCP 配置中（例如，claude_desktop_config.json）：

{
  "mcpServers": {
    "zhook": {
      "command": "npx",
      "args": [
        "-y",
        "@zhook/mcp-server"
      ],
      "env": {
        "ZHOOK_API_KEY": "your_api_key_here"
      }
    }
  }
}

手动安装

npm install -g @zhook/mcp-server

然后运行：

zhook-mcp

配置

此服务需要 Zhook API 密钥来验证请求。您可以在 Zhook 控制面板的用户设置页面获取此密钥。

环境变量	说明	必填
ZHOOK_API_KEY	您的 Zhook API 密钥	是

工具

Hook

• zhook_list_hooks：列出 Zhook 账户中配置的所有 Webhook。
• zhook_get_hook：获取特定 Webhook 的详细配置。
• zhook_create_hook：创建新的 Webhook 或 MQTT Hook。
• zhook_trigger_webhook：向特定 Hook 发送测试 Webhook 事件。

事件

• zhook_list_events：列出特定 Hook 收到的近期事件。
• zhook_get_event：获取特定事件的完整 JSON 负载和详细信息。
• zhook_wait_for_event：连接到 Zhook WebSocket 并等待下一个事件到达。

###目标地址

• zhook_list_destinations：列出特定 Webhook 配置的所有目标地址。
• zhook_get_destination：获取特定目标地址的详细配置。
• zhook_create_destination：向 Hook 添加新的目标地址。
• zhook_update_destination：更新现有目标地址的配置。
• zhook_delete_destination：从 Hook 中移除目标地址。

转换

• zhook_list_transformations：列出特定 Webhook 配置的所有转换。
• zhook_create_transformation：为 Hook 创建新的 JSONata 转换。
• zhook_update_transformation：更新现有转换。
• zhook_delete_transformation：从 Hook 中删除转换。

指标

• zhook_get_hook_metrics：获取实时指标（请求数、成功率和失败率）。
• zhook_get_aggregated_hook_metrics：获取支持自定义日期范围的历史汇总指标。

在编辑器和工具中使用

VSCode

1. 打开命令面板（Ctrl+Shift+P）。
2. 输入并选择 “MCP Servers”（或已配置的扩展命令）。
3. 按照上文所示添加服务配置。

Antigravity（Agent）

1. 点击右上角工具栏中的 “...” (更多选项) 菜单。
2. 选择 “MCP Servers”，然后选择 “Manage MCP Servers”。
3. 添加服务配置（名称：zhook，命令：npx，参数：-y @zhook/mcp-server，环境变量：ZHOOK_API_KEY=...）。

许可证

ISC