Discord Admin MCP Server

Ein Server für das Model Context Protocol (MCP), der strukturierte Tools für die Discord-Serververwaltung, Rollenverwaltung, Mitgliedermoderation und Kanalverwaltung bereitstellt.

Konzipiert für die nahtlose Zusammenarbeit mit Hermes Agent und jedem MCP-kompatiblen Client.

Funktionen & Tools

• Server-Informationen:

  • get_current_bot_user: Untersucht die Identität des Bots und die Benutzerdaten.

  • list_guilds: Listet Server auf, denen der Bot angehört.

  • get_guild_info: Ruft Mitgliederanzahl, Besitzer-ID und Servereinstellungen ab.

• Rollenverwaltung:

  • list_roles: Listet Serverrollen, Positionen und Berechtigungs-Bitfelder auf.

  • assign_role: Weist Mitgliedern Rollen zu.

  • remove_role: Entfernt Rollen von Mitgliedern.

  • create_role: Erstellt neue Rollen mit benutzerdefinierten Farben und Berechtigungen.

  • delete_role: Löscht Rollen vom Server.

• Mitglieder-Moderation:

  • kick_member: Kickt Mitglieder mit Audit-Log-Begründung.

  • ban_member: Bannt Mitglieder mit optionalem Zeitfenster zum Löschen von Nachrichten.

  • unban_member: Entbannt Mitglieder.

  • timeout_member: Versetzt Mitglieder für eine festgelegte Dauer in den Timeout (Stummschaltung/Quarantäne).

• Kanalverwaltung:

  • list_channels: Listet Text-, Sprach-, Forum- und Ankündigungskanäle auf.

  • create_channel: Erstellt Kanäle mit benutzerdefinierten Kategorien/Themen.

  • edit_channel: Bearbeitet Kanalname, NSFW-Status oder Thema.

  • delete_channel: Löscht Kanäle.

• Nachrichtenverwaltung:

  • purge_messages: Löscht kürzlich gesendete Nachrichten in großen Mengen.

Related MCP server: Discord MCP Server

Installation & Einrichtung

1. Voraussetzungen

• Python >= 3.10

• Ein Discord-Bot-Token mit Berechtigungen für die Servermoderation und privilegierten Gateway-Intents (Server Members Intent).

2. Lokale Installation

pip install -e .

3. Umgebungskonfiguration

Setzen Sie die folgenden Umgebungsvariablen (oder fügen Sie sie zu .env / ~/.hermes/.env hinzu):

DISCORD_BOT_TOKEN=your_bot_token_here
DISCORD_DEFAULT_GUILD_ID=your_server_id_here  # Optional fallback

Integration in Hermes Agent

Fügen Sie die Konfiguration zu ~/.hermes/config.yaml hinzu:

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"

Lizenz

MIT-Lizenz – Autor: CommanderBiz