🚀 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": ""
}
}
}
}
配置 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": ""
}
}
}
}
}
🔧 技术细节
环境变量
WEBHOOK_URL（必需）：接收 webhook 通知的 URL 地址。
参数
调用 webhook 时可以传递以下可选参数：
message：包含在 webhook 消息负载中的自定义消息。url：包含在 webhook 负载中的外部 URL，以externalLink形式呈现。
💻 使用示例
开发
构建项目
npm install
npm run build
使用 MCP 监视器进行调试
npm run debug
发布
要发布项目，请按照以下步骤操作：
- 打包项目。
- 上传到目标服务器。
- 配置并启动服务。
项目的源代码托管在 GitHub 上，欢迎 Fork 和贡献！