JinDaGe - discord-mcp MCP Details

article

README

🚀 支持 Discord API 的 MCP 服务器

这是一个支持 Discord API (JDA) 的模型上下文协议 (MCP) 服务器，它能让 Discord 机器人与 MCP 兼容的应用程序（如 Claude Desktop）实现无缝集成。借助该服务器，您的 AI 助手可轻松与 Discord 交互，实现频道管理、消息发送以及服务器信息获取等功能，强大的自动化能力将显著提升您的 Discord 使用体验。

🚀 快速开始

本服务器可助力您的 AI 助手与 Discord 实现无缝交互，以下是使用前的安装与配置步骤。

📦 安装指南

克隆仓库

git clone https://github.com/SaseQ/discord-mcp

构建项目

⚠️ 重要提示

使用 mvn 命令需要安装 Maven。完整的安装说明请参考这里。

cd discord-mcp
mvn clean package # jar 文件将在 /target 目录中生成

配置 AI 客户端

许多代码编辑器和其他 AI 客户端使用配置文件来管理 MCP 服务器。要配置 Discord MPC 服务器，请将以下内容添加到您的配置文件中。

⚠️ 重要提示

您需要创建一个 Discord Bot 令牌才能使用此服务器。有关如何创建 Discord Bot 令牌的说明请参考这里。

{
  "mcpServers": {
    "discord-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/discord-mcp-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_DISCORD_BOT_TOKEN"
      }
    }
  }
}

通过 GitMCP 远程使用

通过 GitMCP 远程使用 Discord MCP：

{
  "mcpServers": {
    "discord-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://gitmcp.io/SaseQ/discord-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_DISCORD_BOT_TOKEN"
      }
    }
  }
}

更多配置信息请参考这里

通过 Smithery 自动安装

通过 Smithery 自动安装 Discord MCP 服务器：

npx -y @smithery/cli@latest install @SaseQ/discord-mcp --client claude

🛠️ 可用工具

服务器信息

get_server_info: 获取详细的 Discord 服务器信息

消息管理

send_message: 向特定频道发送消息
edit_message: 编辑特定频道中的某条消息
delete_message: 删除特定频道中的某条消息
read_messages: 阅读特定频道的历史消息记录
send_private_message: 向特定用户发送私聊消息
edit_private_message: 编辑特定用户的私聊消息
delete_private_message: 删除特定用户的私聊消息
read_private_messages: 阅读特定用户的私聊历史消息记录
add_reaction: 在特定消息上添加一个表情反应
remove_reaction: 从消息中移除指定的表情反应

频道管理

delete_channel: 删除频道
find_channel: 使用名称和服务器 ID 查找频道的类型和 ID
list_channels: 获取所有频道的列表

类别管理

create_category: 创建一个新的类别以容纳频道
delete_category: 删除一个类别
find_category: 使用名称和服务器 ID 查找类别的 ID
list_channels_in_category: 获取指定类别中的所有频道列表

Webhook 管理

create_webhook: 在特定频道上创建一个新的 webhook
delete_webhook: 删除一个 webhook
list_webhooks: 列出特定频道上的所有 webhook
send_webhook_message: 通过 webhook 发送消息

更多详细示例请参考 Wiki。

discord-mcp