使用说明

项目简介

Discord MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它允许大型语言模型 (LLM) 应用通过 MCP 协议与 Discord 机器人进行交互。该服务器将 Discord API 的功能封装成 MCP 工具,例如获取服务器信息、发送消息等,使得 LLM 应用能够利用这些工具来扩展其能力,例如在 Discord 上执行指令、查询信息等。

主要功能点

  • 服务器信息获取: 允许 LLM 应用查询 Discord 服务器的详细信息,例如服务器名称、成员数量、频道列表等。
  • 消息发送: 支持 LLM 应用通过 Discord 机器人向指定频道或用户发送消息。
  • 工具注册与执行: 基于 Spring AI Tool 框架,将 Discord API 功能注册为 MCP 工具,方便 LLM 客户端调用。
  • Smithery 集成: 支持通过 Smithery 快速安装和部署,简化服务器配置过程。

安装步骤

  1. 克隆仓库
    git clone https://github.com/SaseQ/discord-mcp
    cd discord-mcp
  2. 构建项目 确保已安装 Maven。在项目根目录下执行:
    mvn clean package
    构建成功后,会在 'target' 目录下生成 'discord-mcp-0.0.1-SNAPSHOT.jar' 文件。

服务器配置

MCP 客户端(例如 Claude Desktop)需要配置 MCP 服务器的启动命令才能连接。以下是针对 Discord MCP Server 的配置信息,请添加到 MCP 客户端的服务器配置中。

{
  "servers": {
    "discord-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "/绝对路径/discord-mcp-0.0.1-SNAPSHOT.jar"  // 将 "/绝对路径" 替换为 discord-mcp-0.0.1-SNAPSHOT.jar 文件的实际路径
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_DISCORD_BOT_TOKEN" // 将 "YOUR_DISCORD_BOT_TOKEN" 替换为你的 Discord 机器人令牌
      }
    }
  }
}

配置参数说明:

  • 'server name': 'discord-mcp' (服务器名称,可自定义)
  • 'command': 'java' (启动命令,使用 Java 运行时环境)
  • 'args': '["-jar", "/绝对路径/discord-mcp-0.0.1-SNAPSHOT.jar"]' (启动参数,指定 JAR 文件路径)
  • 'env': '{"DISCORD_TOKEN": "YOUR_DISCORD_BOT_TOKEN"}' (环境变量,用于配置 Discord 机器人令牌,请前往 Discord Developer Portal 获取)

注意: 请务必将 '/绝对路径/discord-mcp-0.0.1-SNAPSHOT.jar' 替换为实际的 JAR 文件路径,并将 'YOUR_DISCORD_BOT_TOKEN' 替换为你的 Discord 机器人令牌。

基本使用方法

  1. 启动 Discord MCP Server。

  2. 在 MCP 客户端中配置并连接到 Discord MCP Server。

  3. 在 LLM 应用中,可以使用以下工具与 Discord 进行交互:

    • 'get_server_info(guildId)': 获取指定 Discord 服务器 ID ('guildId') 的详细信息。
    • 'send_message(message, channelId)': 向指定 Discord 频道 ID ('channelId') 发送消息 ('message')。
    • 'send_private_message(message, userId)': 向指定 Discord 用户 ID ('userId') 发送私信 ('message')。

    LLM 应用可以通过自然语言指令调用这些工具,例如:

    • "获取服务器 ID 为 123456 的服务器信息" (对应 'get_server_info' 工具)
    • "在频道 ID 为 789012 的频道发送消息 '你好!'" (对应 'send_message' 工具)
    • "向用户 ID 为 456789 的用户发送私信 '请注意查收消息'" (对应 'send_private_message' 工具)

    具体的工具调用方式和参数格式请参考 MCP 客户端和 LLM 应用的文档。

更多信息

更详细的示例和使用方法可以参考 Wiki

信息

分类

通信与社交