MCP Webhook Server 使用说明

项目简介

MCP Webhook Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它通过 Webhook 功能扩展了 LLM 应用的能力。该服务器提供了一个 'send_message' 工具，允许 LLM 控制的应用通过 MCP 协议向预设的 Webhook URL 发送消息，从而实现与外部系统的集成和自动化。

主要功能点

Webhook 集成: 允许 LLM 应用通过 MCP 协议向任何指定的 Webhook URL 发送消息。
消息发送工具: 提供 'send_message' 工具，LLM 可以调用此工具发送文本消息到 Webhook URL。
自定义消息: 支持在发送消息时自定义用户名和头像 URL。

安装步骤

前提条件: 确保您已安装 Node.js 18 或更高版本。

安装: 使用 npm 安装 '@kevinwatt/mcp-webhook' 包：

npm install @kevinwatt/mcp-webhook

服务器配置

为了让 MCP 客户端（如 Dive Desktop）连接到 Webhook Server，您需要配置 MCP 服务器信息。以下是一个配置示例，您可以将其添加到 MCP 客户端的配置文件中。请注意，您需要将 'your-webhook-url' 替换为您实际的 Webhook URL。

{
  "mcpServers": {
    "webhook": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/mcp-webhook"
      ],
      "env": {
        "WEBHOOK_URL": "your-webhook-url"  //  请替换为您的 Webhook URL，例如 "https://your-webhook-site.com/api/webhook"
      },
      "alwaysAllow": [
        "send_message"
      ]
    }
  }
}

配置参数说明:

'server name': 'webhook' (服务器名称，可以自定义，用于在客户端中标识该服务器)
'command': 'npx' (用于执行 npm 包的命令，确保您的环境中已安装 npx)
'args': '["-y", "@kevinwatt/mcp-webhook"]' (启动 Webhook Server 的参数，'-y' 参数用于跳过 npm 包安装时的确认提示)
'env': 环境变量配置
- 'WEBHOOK_URL': 必填，您要发送消息的目标 Webhook URL。Webhook Server 将向这个 URL 发送 POST 请求。
'alwaysAllow': '["send_message"]' (声明允许 LLM 客户端无需用户授权即可调用的工具，这里设置为允许始终调用 'send_message' 工具)

基本使用方法

配置完成后，在 MCP 客户端中，您可以指示 LLM 调用 'send_message' 工具来发送消息。以下是一些示例指令，您可以向 LLM 发出类似指令：

'Send a message to webhook: Hello World!' (发送内容为 "Hello World!" 的消息到 Webhook)
'Send a message with custom name: content='Testing', username='Bot'' (发送内容为 "Testing" 的消息，并设置用户名为 "Bot")

LLM 接收到这些指令后，会解析并调用 'send_message' 工具，Webhook Server 会将消息通过 POST 请求发送到您配置的 'WEBHOOK_URL'。

关键词