Discord Admin MCP Server

A Model Context Protocol (MCP) server providing structured tools for Discord server administration, role management, member moderation, and channel operations.

Designed to work seamlessly with Hermes Agent and any MCP-compliant client.

Features & Tools

• Server Info:

  • get_current_bot_user: Inspect the bot's identity and user details.
  • list_guilds: List servers the bot belongs to.
  • get_guild_info: Get member counts, owner ID, server settings.

• Role Management:

  • list_roles: List server roles, positions, and permission bitfields.
  • assign_role: Assign roles to members.
  • remove_role: Remove roles from members.
  • create_role: Create new roles with custom colors and permissions.
  • delete_role: Delete roles from the server.

• Member Moderation:

  • kick_member: Kick members with audit log reason.
  • ban_member: Ban members with optional message purge window.
  • unban_member: Unban members.
  • timeout_member: Timeout (mute/quarantine) members for a set duration.

• Channel Management:

  • list_channels: List text, voice, forum, and announcement channels.
  • create_channel: Create channels with custom categories/topics.
  • edit_channel: Edit channel name, NSFW status, or topic.
  • delete_channel: Delete channels.

• Message Admin:

  • purge_messages: Bulk delete recent messages.

Installation & Setup

1. Requirements

• Python >= 3.10
• A Discord Bot Token with Server Moderation permissions and Privileged Gateway Intents (Server Members Intent).

2. Local Install

pip install -e .

3. Environment Configuration

Set the following environment variables (or add them to .env / ~/.hermes/.env):

DISCORD_BOT_TOKEN=your_bot_token_here
DISCORD_DEFAULT_GUILD_ID=your_server_id_here  # Optional fallback

Hermes Agent Integration

Add to ~/.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"

License

MIT License - Author: CommanderBiz