Servidor MCP de Administración de Discord

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas estructuradas para la administración de servidores de Discord, gestión de roles, moderación de miembros y operaciones de canales.

Diseñado para funcionar sin problemas con Hermes Agent y cualquier cliente compatible con MCP.

Características y Herramientas

• Información del Servidor:

  • get_current_bot_user: Inspecciona la identidad y los detalles del bot.

  • list_guilds: Lista los servidores a los que pertenece el bot.

  • get_guild_info: Obtiene el número de miembros, el ID del propietario y la configuración del servidor.

• Gestión de Roles:

  • list_roles: Lista los roles del servidor, sus posiciones y los bitfields de permisos.

  • assign_role: Asigna roles a los miembros.

  • remove_role: Elimina roles de los miembros.

  • create_role: Crea nuevos roles con colores y permisos personalizados.

  • delete_role: Elimina roles del servidor.

• Moderación de Miembros:

  • kick_member: Expulsa a miembros con motivo en el registro de auditoría.

  • ban_member: Banea a miembros con opción de purgar mensajes.

  • unban_member: Desbanea a miembros.

  • timeout_member: Aplica tiempo de espera (silencio/aislamiento) a miembros durante una duración determinada.

• Gestión de Canales:

  • list_channels: Lista canales de texto, voz, foro y anuncios.

  • create_channel: Crea canales con categorías/temas personalizados.

  • edit_channel: Edita el nombre del canal, el estado NSFW o el tema.

  • delete_channel: Elimina canales.

• Administración de Mensajes:

  • purge_messages: Elimina masivamente mensajes recientes.

Related MCP server: Discord MCP Server

Instalación y Configuración

1. Requisitos

• Python >= 3.10

• Un token de bot de Discord con permisos de moderación de servidor e intents privilegiados (Server Members Intent).

2. Instalación Local

pip install -e .

3. Configuración del Entorno

Establece las siguientes variables de entorno (o agrégalas a .env / ~/.hermes/.env):

DISCORD_BOT_TOKEN=your_bot_token_here
DISCORD_DEFAULT_GUILD_ID=your_server_id_here  # Optional fallback

Integración con Hermes Agent

Agrega a ~/.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"

Licencia

Licencia MIT - Autor: CommanderBiz