webhook-mcp

🚀 Webhook 通知 MCP 服务器

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

🚀 快速开始

本服务器可与 webhook 通知服务集成，在长耗时任务完成时发出通知。下面为你详细介绍配置方法。

📦 安装指南

有多种方式可以配置 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_URL（必需）：接收 webhook 通知的 URL 地址。

参数

调用 webhook 时可以传递以下可选参数：

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

💻 使用示例

开发

构建项目

npm install
npm run build

使用 MCP 监视器进行调试

npm run debug

发布

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

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

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