Advanced Discord MCP

断开MCP服务器

一种模型上下文协议（MCP）服务器，为MCP客户端提供Discord集成功能。

备注：这是一个 增强型叉子 的原件 mcp不和 存储库 大量的新功能 补充。

特性

服务器信息

• list_servers：列出机器人所属的所有Discord服务器（公会）
• get_server_info：获取详细的服务器信息
• list_members：列出服务器成员及其角色
• get_server_settings：检索当前服务器配置
• modify_server_settings：更新服务器名称、描述、图标、横幅、验证、通知、AFK、系统频道、显式内容过滤器和区域设置

消息管理

• send_message：向频道发送消息
• read_messages：读取最近的消息历史记录
• edit_message：编辑现有邮件
• get_message：通过ID获取特定消息
• add_reaction：在消息中添加反应
• add_multiple_reactions：在消息中添加多个反应
• remove_reaction：从消息中删除反应
• pin_message：将消息固定在频道中
• unpin_message：从频道中打开消息
• moderate_message：删除消息和超时用户
• bulk_delete_messages：一次删除多条消息（2-100条消息）

渠道管理

• create_text_channel：创建新的文本频道
• create_voice_channel：创建新的语音频道
• list_channels：列出服务器中的所有频道（显示类别并对频道进行排序）
• get_channel_info：获取频道的详细信息
• modify_channel：修改频道属性（名称、主题、权限、类别等）
• delete_channel：删除现有频道

角色管理

• create_role：在服务器中创建新角色
• delete_role：从服务器中删除角色
• modify_role：修改角色属性（名称、颜色、权限、职位等）
• list_roles：列出服务器中的所有角色及其详细信息（包括职位信息）
• get_role_info：获取特定角色的详细信息
• set_role_hierarchy：通过指定角色顺序（从高到低）设置角色层次结构

- 支持角色ID和角色名称（不区分大小写） - 自动处理机器人角色限制 - 智能计算机器人角色以下的位置

• add_role：向用户添加角色
• remove_role：从用户中删除角色

权限管理

• check_bot_permissions：检查机器人在通道或服务器中拥有哪些权限
• check_member_permissions：检查成员在通道或服务器中的权限
• configure_channel_permissions：配置频道中角色或成员的权限
• list_discord_permissions：列出所有可用的Discord权限及其说明

邀请管理

• create_invite：创建具有使用限制和过期的频道邀请
• list_invites：列出活动服务器邀请
• get_invite_info：获取邀请的详细信息
• delete_invite：撤销邀请

自动调节和规则

• create_automod_rule：创建自动审核规则
• list_automod_rules：列出自动审核规则
• modify_automod_rule：更新自动审核规则
• delete_automod_rule：删除自动审核规则

线程管理

• create_thread：从消息或独立创建线程
• list_threads：列出活动或已存档的线程
• archive_thread：存档一个线程
• unarchive_thread：取消归档线程
• delete_thread：删除线程

品类管理

• create_category：创建频道类别
• modify_category：修改类别名称、职位或权限
• delete_category：删除类别（可选择移动频道）

表情符号ITO；贴纸管理

• create_emoji：创建自定义表情符号
• list_emojis：列出服务器表情符号
• delete_emoji：删除自定义表情符号
• create_sticker：创建自定义贴纸
• list_stickers：列出服务器贴纸
• delete_sticker：删除自定义贴纸

Webhook管理

• create_webhook：创建新的webhook
• list_webhooks：列出频道中的Webhook
• send_webhook_message：通过webhook发送消息
• modify_webhook：更新webhook设置
• delete_webhook：删除webhook

用户管理

• get_user_info：获取Discord用户的信息
• get_member_info：获取服务器成员的详细信息
• modify_member：修改成员属性（昵称、超时等）
• ban_user：禁止用户访问服务器
• unban_user：取消用户与服务器的连接
• kick_user：从服务器上踢用户

此叉子的新功能

这款增强型叉子包括 广泛的新功能 超出原始项目：

最近的改进

• 增强 list_channels：现在显示频道类别并按位置对频道进行排序
• 类别支持 modify_channel：在类别之间移动频道或将其从类别中删除
• list_servers 工具：列出机器人程序所属的所有服务器
• 角色层次结构管理：增强 set_role_hierarchy 改进了位置计算和自动机器人角色处理的工具

- 支持角色ID和角色名称（不区分大小写匹配） - 自动跳过机器人自己的角色（机器人无法编辑自己的角色位置） - 智能计算职位，以确保角色低于机器人的角色 - 当角色位于机器人位置之上时，优雅地处理权限错误

• 增强 list_roles：现在显示角色位置以帮助可视化层次结构
• 位置支持 modify_role：设置单个角色职位以控制层次结构

权限管理

• check_bot_permissions：检查机器人在通道或服务器中拥有哪些权限
• check_member_permissions：检查成员在通道或服务器中的权限
• configure_channel_permissions：配置频道中角色或成员的权限
• list_discord_permissions：列出所有可用的Discord权限及其说明

批量操作

• bulk_add_roles：向多个用户添加角色
• bulk_modify_members：在一次呼叫中更新多个成员（昵称、超时）

智能搜索和筛选

• search_messages：按内容、作者或频道内的日期范围搜索邮件
• find_members_by_criteria：按角色、加入日期、姓名或机器人状态查找成员

计划任务

• schedule_task：安排支持的任务稍后运行
• send_scheduled_message：安排稍后发送的消息

分析

• generate_server_analytics：生成基本服务器分析
• generate_channel_analytics：为渠道生成基本分析

自动化规则

• create_automation_rule：创建自动化规则定义

模板

• create_message_template：创建可重用的消息模板
• create_role_template：创建可重用的角色模板

智能调节与分析

• analyze_message_patterns：分析垃圾邮件指示器的消息模式
• auto_moderate_by_pattern：基于简单垃圾邮件模式的自动审核邮件

高级分析

• track_metrics：随时间跟踪自定义指标
• export_data：导出存储的数据（指标、模板、自动化规则）

渠道组织

• auto_organize_channels：将非活动频道移动到目标类别
• create_channel_structure：从模板创建通道结构

先决条件

1. 设置你的Discord机器人:

- 在以下位置创建新应用程序 Discord开发者门户 - 创建一个机器人并复制令牌 - 启用所需的特权意图： - 消息内容意图 - 在场意图 - 服务器成员意图 - 使用OAuth2 URL生成器将机器人邀请到您的服务器

1. Python要求:

- Python 3.10或更高版本 - pip（Python包安装程序）

安装

1. 克隆存储库:

   git clone 
   cd mcp-discord-main

1. 创建和激活虚拟环境:

   # On Windows
   python -m venv venv
   venv\Scripts\activate

   # On macOS/Linux
   python -m venv venv
   source venv/bin/activate

1. 安装依赖项:

   pip install -e .

注意：如果使用Python 3.13+，还需要安装audioop： pip install audioop-lts

1. 配置您的MCP客户端:

将以下内容添加到MCP客户端配置文件中：

{
  "mcpServers": {
    "discord": {
      "command": "python",
      "args": ["-m", "discord_mcp"],
      "cwd": "path/to/mcp-discord-main",
      "env": {
        "DISCORD_TOKEN": "your_bot_token"
      }
    }
  }
}

注：

• 将“path/to/mcp-discord main”替换为克隆存储库的实际路径
• 将“your_bot_token”替换为您的Discord机器人令牌
• 有关配置文件的确切位置，请参阅MCP客户端的文档

调试

如果遇到问题，请检查MCP客户端的日志以获取详细的错误消息。

常见问题：

1. 令牌错误:

- 验证您的Discord机器人令牌是否正确 - 检查是否启用了所有必需的意图

1. 权限问题:

- 确保机器人在您的Discord服务器中具有适当的权限 - 验证机器人角色管理命令的角色层次结构

1. 安装问题:

- 确保你使用的是正确的Python版本 - 尝试重新创建虚拟环境 - 检查是否正确安装了所有依赖项

许可证

GNU通用公共许可证v3.0（GPLv3）-有关详细信息，请参阅许可证文件。

______________________________________________________________________

备注：这是原始版本的增强版本 mcp不和 添加了大量新功能的存储库。