Discord Admin MCP Server

一个提供结构化工具的 Model Context Protocol (MCP) 服务器，用于 Discord 服务器管理、角色管理、成员管理和频道操作。

旨在与 Hermes Agent 及任何兼容 MCP 的客户端无缝协作。

功能与工具

• 服务器信息：

  • get_current_bot_user：检查机器人的身份和用户详细信息。

  • list_guilds：列出机器人所属的服务器。

  • get_guild_info：获取成员数量、所有者 ID 和服务器设置。

• 角色管理：

  • list_roles：列出服务器角色、位置和权限位域。

  • assign_role：为成员分配角色。

  • remove_role：从成员移除角色。

  • create_role：创建具有自定义颜色和权限的新角色。

  • delete_role：从服务器删除角色。

• 成员管理：

  • kick_member：踢出成员并附带审计日志原因。

  • ban_member：封禁成员，可选择消息清除时间窗口。

  • unban_member：解除封禁成员。

  • timeout_member：对成员进行超时（禁言/隔离）处理，持续一段设定时间。

• 频道管理：

  • list_channels：列出文本、语音、论坛和公告频道。

  • create_channel：创建具有自定义类别/主题的频道。

  • edit_channel：编辑频道名称、NSFW 状态或主题。

  • delete_channel：删除频道。

• 消息管理：

  • purge_messages：批量删除最近的消息。

Related MCP server: Discord MCP Server

安装与设置

1. 要求

• Python >= 3.10

• 一个具有服务器管理权限和特权网关意图（服务器成员意图）的 Discord 机器人令牌。

2. 本地安装

pip install -e .

3. 环境配置

设置以下环境变量（或将它们添加到 .env / ~/.hermes/.env）：

DISCORD_BOT_TOKEN=your_bot_token_here
DISCORD_DEFAULT_GUILD_ID=your_server_id_here  # Optional fallback

Hermes Agent 集成

添加到 ~/.hermes/config.yaml：

mcp_servers:
  discord_admin:
    command: "/home/kernel/hermes-venv/bin/python3"
    args: ["-m", "discord_admin_mcp.server"]
    env:
      DISCORD_BOT_TOKEN: "your_bot_token_here"

许可证

MIT License - 作者：CommanderBiz