🚀 Webhook 通知 MCP 服务器

这是一个模型上下文协议（MCP）服务器，在被调用时会发送 webhook 通知。借助该服务器，你能够与 webhook 通知服务（如 Echobell）集成，当长耗时任务完成时及时收到通知。你只需配置服务器的 Echobell webhook URL（或其他服务的 URL），并指示 AI 助手在任务提示中添加“完成时通知我”即可。

🚀 快速开始

本服务器可与 webhook 通知服务集成，让你在长耗时任务完成时收到通知。你只需配置好服务器的 webhook URL，并让 AI 助手在任务提示中添加“完成时通知我”。

✨ 主要特性

• 可与多种 webhook 通知服务集成，如 Echobell。
• 支持多种配置方式，包括使用 Smithery 安装、集成 Claude、Cursor、Windsurf 以及 VS Code 等。
• 调用时可传递可选参数，如自定义消息和外部 URL。

📦 安装指南

有多种方式可以配置 MCP 服务器：

使用 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 时可以传递以下可选参数：

• message：包含在 webhook 消息负载中的自定义消息。
• url：包含在 webhook 负载中的外部 URL，以 externalLink 形式呈现。

🔧 技术细节

开发

要构建项目：

npm install
npm run build

要使用 MCP 监视器进行调试：

npm run debug

发布

要发布项目，请按照以下步骤操作：

1. 打包项目。
2. 上传到目标服务器。
3. 配置并启动服务。

项目的源代码托管在 GitHub 上，欢迎 Fork 和贡献！