使用说明

项目简介

本项目 'Discord Webhook MCP Server' 是一个基于 Model Context Protocol (MCP) 的服务器实现,旨在为大型语言模型 (LLM) 应用提供向 Discord 频道发送消息的功能。通过注册 'send_message' 工具,LLM 客户端可以调用此服务器向预设的 Discord Webhook URL 发送文本消息,从而实现自动化通知、内容发布等应用场景。

主要功能点

  • 发送 Discord 消息: 提供 'send_message' 工具,允许 LLM 应用发送文本消息到指定的 Discord 频道。
  • 可配置用户名和头像: 'send_message' 工具支持可选的 'username' 和 'avatar_url' 参数,用于自定义消息在 Discord 中显示的发件人名称和头像。
  • 基于 MCP 协议: 遵循 MCP 协议标准,易于集成到支持 MCP 协议的 LLM 客户端中。
  • 简单的部署和配置: 通过 npm 安装,并通过环境变量配置 Discord Webhook URL。

安装步骤

  1. 确保你的环境中已安装 Node.js 和 npm。
  2. 打开终端,运行以下命令安装 'discord-webhook-mcp-server':
    npm install @genpm/mcp-server-discord-webhook

服务器配置

为了让 MCP 客户端能够连接并使用此 MCP 服务器,需要在客户端的 MCP 配置中添加以下服务器配置信息。 请务必将 'your-discord-webhook-url' 替换为你实际的 Discord Webhook URL。

{
  "mcpServers": {
    "discord-webhook": {
      "command": "npx",
      "args": [
        "-y",
        "@genpm/mcp-server-discord-webhook"
      ],
      "env": {
        "DISCORD_WEBHOOK_URL": "your-discord-webhook-url" // 替换为你的 Discord Webhook URL
      },
      "alwaysAllow": [
        "send_message"
      ]
    }
  }
}

配置参数说明:

  • 'server name': 'discord-webhook' (服务器名称,客户端通过此名称调用)
  • 'command': 'npx' (启动服务器的命令,通常使用 npx 执行 npm 包)
  • 'args':
    • '-y': (npx 参数,自动确认执行 npm 包)
    • '@genpm/mcp-server-discord-webhook': (要执行的 npm 包名称,即此 MCP 服务器)
  • 'env':
    • 'DISCORD_WEBHOOK_URL': 'your-discord-webhook-url' (环境变量,必须替换为你的 Discord Webhook URL, 用于配置 Discord Webhook 的地址)
  • 'alwaysAllow':
    • 'send_message': (总是允许客户端调用的工具名称,无需用户额外授权)

重要提示: 在运行 MCP 客户端之前,请确保已经设置了 'DISCORD_WEBHOOK_URL' 环境变量,并将其值设置为你的 Discord Webhook URL。

基本使用方法

在 LLM 应用中,可以使用 '<use_mcp_tool>' 标签调用 'discord-webhook' 服务器的 'send_message' 工具来发送消息。以下是一个示例:

<use_mcp_tool>
  <server_name>discord-webhook</server_name>
  <tool_name>send_message</tool_name>
  <arguments>
    {
      "content": "来自 LLM 的消息!",
      "username": "智能助手",
      "avatar_url": "https://example.com/avatar.png"
    }
  </arguments>
</use_mcp_tool>

这段 XML 代码指示 MCP 客户端调用名为 'discord-webhook' 的服务器,执行 'send_message' 工具,并传递包含消息内容、用户名和头像 URL 的参数。服务器会将消息发送到配置的 Discord Webhook 频道。

信息

分类

通信与社交