MCP Discord

🚀 MCP Discord扩展

具备高级服务器管理功能的Discord MCP服务器

这是适用于Discord的扩展版模型上下文协议服务器。它派生自 barryyip0625/mcp-discord，并添加了用于完整服务器管理的额外功能。

✨ 主要特性

🚀 快速开始

要求

• Node.js v20.0.0 或更高版本
• 具有管理员权限的 Discord 机器人
• 从 Discord 开发者门户 获取的 机器人令牌

📦 安装指南

git clone https://github.com/Kogollones/mcp-discord.git
cd mcp-discord
npm install

配置

将以下内容添加到你的Claude桌面 (claude_desktop_config.json) 或Claude代码设置中：

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": [
        "C:/path/to/mcp-discord/build/index.js",
        "--config",
        "YOUR_DISCORD_BOT_TOKEN"
      ]
    }
  }
}

📚 详细文档

服务器与登录

频道管理

角色管理

权限管理

成员管理

消息管理

反应

论坛

Webhook

批量操作

权限名称

discord_set_channel_permissions 可用的权限标志如下：

ViewChannel          SendMessages         ReadMessageHistory
ManageMessages       ManageChannels       ManageRoles
Connect              Speak                MuteMembers
DeafenMembers        MoveMembers          ManageWebhooks
AddReactions         AttachFiles          EmbedLinks
CreateInstantInvite  UseExternalEmojis    ManageThreads
SendMessagesInThreads

💻 使用示例

基础用法

对 @everyone 隐藏类别

discord_set_channel_permissions({
  channelId: "CATEGORY_ID",
  targetId: "EVERYONE_ROLE_ID", // 与公会ID相同
  targetType: "role",
  deny: ["ViewChannel"]
})

允许角色访问类别

discord_set_channel_permissions({
  channelId: "CATEGORY_ID",
  targetId: "ROLE_ID",
  targetType: "role",
  allow: ["ViewChannel", "SendMessages", "ReadMessageHistory"]
})

高级用法

创建带颜色的角色

discord_create_role({
  guildId: "SERVER_ID",
  name: "Developer",
  color: "#3498DB",
  hoist: true,
  mentionable: true
})

批量删除消息

discord_bulk_delete_messages({
  channelId: "CHANNEL_ID",
  limit: 50
})

依赖项

鸣谢

• 原作者：Barry Yip
• 扩展者：Kogollones

📄 许可证

MIT - 版权所有 (c) 2025 BarryY（原作者），Kogollones（扩展者）