Zhook Mcp Server

@zhook/mcp-server

zhook の公式 Model Context Protocol（MCP）サーバーです。AI エージェントが Zhook の Webhook、イベント、メトリクスを操作できるようにします。

特長

• フックの作成：エージェントから新しい Webhook または MQTT フックを直接作成します。
• フックの一覧表示：設定済みの Webhook の一覧を取得します。
• イベントの確認：特定のフックの最近のイベントを表示します。
• イベントを待機：実行を一時停止し、特定のイベントが発生するまで待機します。
• メトリクス：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 キー	はい

ツール

フック

• zhook_list_hooks：Zhook アカウントに設定されているすべての Webhook を一覧表示します。
• zhook_get_hook：特定の Webhook の詳細な設定を取得します。
• zhook_create_hook：新しい Webhook または MQTT フックを作成します。
• zhook_trigger_webhook：特定のフックにテスト用の Webhook イベントを送信します。

イベント

• zhook_list_events：特定のフックが受信した最近のイベントを一覧表示します。
• zhook_get_event：特定のイベントの完全な JSON ペイロードと詳細を取得します。
• zhook_wait_for_event：Zhook WebSocket に接続し、次のイベントが届くまで待機します。

宛先

• zhook_list_destinations：特定の Webhook に設定されているすべての宛先を一覧表示します。
• zhook_get_destination：特定の宛先の詳細な設定を取得します。
• zhook_create_destination：フックに新しい宛先を追加します。
• zhook_update_destination：既存の宛先の設定を更新します。
• zhook_delete_destination：フックから宛先を削除します。

変換

• zhook_list_transformations：特定の Webhook に設定されているすべての変換を一覧表示します。
• zhook_create_transformation：フック用の新しい JSONata 変換を作成します。
• zhook_update_transformation：既存の変換を更新します。
• zhook_delete_transformation：フックから変換を削除します。

メトリクス

• zhook_get_hook_metrics：リアルタイムのメトリクス（リクエスト数、成功率／失敗率）を取得します。
• zhook_get_aggregated_hook_metrics：カスタムの日付範囲を指定して、過去の集計メトリクスを取得します。

エディターとツールでの使用

VSCode

1. コマンドパレットを開きます（Ctrl+Shift+P）。
2. 「MCP Servers」（または設定済みの拡張機能コマンド）と入力して選択します。
3. 上記のとおりにサーバー設定を追加します。

Antigravity（エージェント）

1. 右上のツールバーにある 「...」（その他のオプション） メニューをクリックします。
2. 「MCP Servers」 を選択し、次に 「Manage MCP Servers」 を選択します。
3. サーバー設定を追加します（Name：zhook、Command：npx、Args：-y @zhook/mcp-server、Env：ZHOOK_API_KEY=...）。

ライセンス

ISC