Webhook MCP

🚀 Webhook 通知 MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）サーバーで、呼び出されると webhook 通知を送信します。

このサーバーを使用すると、Echobell などの webhook 通知サービスと統合でき、長時間かかるタスクが完了したときに通知を受け取ることができます。サーバーの Echobell webhook URL（または他のサービスの URL）を設定し、AI アシスタントにタスクの指示に「完了時に通知して」を追加するだけです。

🚀 クイックスタート

✨ 主な機能

• モデルコンテキストプロトコル（MCP）サーバーとして機能し、呼び出されると webhook 通知を送信します。
• Echobell などの webhook 通知サービスと統合可能で、長時間タスクの完了通知を受け取れます。

📦 インストール

使用 Smithery インストール

Smithery を通じて Webhook MCP サーバーを自動インストールします。

npx -y @smithery/cli install @noobnooc/webhook-mcp --client claude

🔧 設定方法

Claude & Cursor & Windsurf の設定

設定ファイルに以下の内容を追加し、Claude、Cursor、または Windsurf を MCP サーバーと統合します。

• NPM を使用する場合

{
  "mcpServers": {
    "notification": {
      "command": "npx",
      "args": ["-y", "webhook-mcp"],
      "env": {
        "WEBHOOK_URL": "your-webhook-url-here"
      }
    }
  }
}

• Docker を使用する場合

{
  "mcpServers": {
    "notification": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "WEBHOOK_URL",
        "noobnooc/webhook-mcp"
      ],
      "env": {
        "WEBHOOK_URL": "<your-webhook-url-here>"
      }
    }
  }
}

VS Code の設定

VS Code の settings.json に以下の設定を追加します。

• NPM を使用する場合

{
  "mcp": {
    "servers": {
      "notification": {
        "command": "npx",
        "args": ["-y", "webhook-mcp"],
        "env": {
          "WEBHOOK_URL": "your-webhook-url-here"
        }
      }
    }
  }
}

• Docker を使用する場合

{
  "mcp": {
    "servers": {
      "notification": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "WEBHOOK_URL",
          "noobnooc/webhook-mcp"
        ],
        "env": {
          "WEBHOOK_URL": "<your-webhook-url-here>"
        }
      }
    }
  }
}

🔧 環境変数

• WEBHOOK_URL（必須）：webhook 通知を受け取る URL アドレスです。

🔧 パラメータ

webhook を呼び出す際に、以下のオプションパラメータを渡すことができます。

• message：webhook メッセージのペイロードに含まれるカスタムメッセージです。
• url：webhook ペイロードに含まれる外部 URL で、externalLink 形式で表示されます。

🔧 開発

プロジェクトのビルド

npm install
npm run build

MCP モニターを使用したデバッグ

npm run debug

🔧 公開

プロジェクトを公開するには、以下の手順に従ってください。

1. プロジェクトをパッケージ化します。
2. ターゲットサーバーにアップロードします。
3. サービスを設定して起動します。

プロジェクトのソースコードは GitHub でホストされており、Fork や貢献を歓迎します！