Discord MCP

📖 Descripción

Un servidor de Model Context Protocol (MCP) para la API de Discord que utiliza (JDA), diseñado para integrar bots de Discord con aplicaciones compatibles con MCP como Claude, ChatGPT, etc. Permite que los asistentes de IA interactúen con Discord gestionando canales, enviando mensajes y recuperando información del servidor. Ideal para construir potentes automatizaciones de Discord y flujos de trabajo impulsados por IA.

🔬 Instalación

► 🐳 Instalación con Docker (Recomendada)

[!NOTE] Se requiere la instalación de Docker. Puedes encontrar instrucciones completas en docker.com.

1) Configurar variables de entorno locales

export DISCORD_TOKEN="YOUR_DISCORD_BOT_TOKEN"
export DISCORD_GUILD_ID="OPTIONAL_DEFAULT_SERVER_ID"
export SPRING_PROFILES_ACTIVE=http

[!IMPORTANT] Las instrucciones para crear un bot de Discord y obtener su token se pueden encontrar aquí.

[!TIP] La variable de entorno DISCORD_GUILD_ID es opcional.

Cuando se proporciona, establece un ID de servidor de Discord predeterminado para que cualquier herramienta que acepte un parámetro guildId pueda omitirlo.

2) Ejecutar el contenedor Docker

docker run -d -i \
  --name discord-mcp \
  --restart unless-stopped \
  -p 8085:8085 \
  -e SPRING_PROFILES_ACTIVE \
  -e DISCORD_TOKEN \
  -e DISCORD_GUILD_ID \
  saseq/discord-mcp:latest

URL de endpoint MCP predeterminada (perfil HTTP): http://localhost:8085/mcp

git clone https://github.com/SaseQ/discord-mcp

cd discord-mcp

cat > .env <<EOF
SPRING_PROFILES_ACTIVE=http
DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>
DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>
EOF

docker compose up -d --build

docker ps --filter name=discord-mcp
curl -fsS http://localhost:8085/actuator/health

git clone https://github.com/SaseQ/discord-mcp

cd discord-mcp
mvn clean package # The jar file will be available in the /target directory

DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN> \
DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID> \
SPRING_PROFILES_ACTIVE=http \
java -jar /absolute/path/to/discord-mcp-1.0.0.jar

🔗 Conexiones

► 🗞️ Conexión con config.json predeterminada

Recomendado (modo singleton HTTP):

{
  "mcpServers": {
    "discord-mcp": {
      "url": "http://localhost:8085/mcp"
    }
  }
}

Modo heredado (stdio, inicia un nuevo proceso/contenedor por sesión de cliente):

{
  "mcpServers": {
    "discord-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
        "-e",
        "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
        "saseq/discord-mcp:latest"
      ]
    }
  }
}

claude mcp add discord-mcp --transport http http://localhost:8085/mcp

claude mcp add discord-mcp -- docker run --rm -i -e DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN> -e DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID> saseq/discord-mcp:latest

codex mcp add discord-mcp --url http://localhost:8085/mcp
codex mcp list

openclaw mcp set discord-mcp '{"url":"http://localhost:8085/mcp","transport":"streamable-http"}'
openclaw mcp list

{
  "mcp": {
    "servers": {
      "discord-mcp": {
        "url": "http://localhost:8085/mcp",
        "transport": "streamable-http"
      }
    }
  }
}

{
  "mcpServers": {
    "discord-mcp": {
      "url": "http://localhost:8085/mcp"
    }
  }
}

{
  "mcpServers": {
    "discord-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
        "-e",
        "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
        "saseq/discord-mcp:latest"
      ]
    }
  }
}

🛠️ Herramientas Disponibles

Información del Servidor

• get_server_info: Obtén información detallada del servidor de Discord

Gestión de Usuarios

• get_user_id_by_name: Obtén el ID de un usuario de Discord por nombre de usuario en un servidor para uso en menciones <@id>
• send_private_message: Envía un mensaje privado a un usuario específico
• edit_private_message: Edita un mensaje privado de un usuario específico
• delete_private_message: Elimina un mensaje privado de un usuario específico
• read_private_messages: Lee el historial de mensajes privados de un usuario específico (incluye metadatos de archivos adjuntos, admite count 1-100 y cursor opcional: before o after o around)

Gestión de Mensajes

• send_message: Envía un mensaje a un canal específico
• edit_message: Edita un mensaje de un canal específico
• delete_message: Elimina un mensaje de un canal específico
• read_messages: Lee el historial de mensajes de un canal específico (incluye metadatos de archivos adjuntos, admite count 1-100 y cursor opcional: before o after o around)
• add_reaction: Añade una reacción (emoji) a un mensaje específico
• remove_reaction: Elimina una reacción específica (emoji) de un mensaje

Gestión de Canales

• create_text_channel: Crea un nuevo canal de texto
• edit_text_channel: Edita la configuración de un canal de texto (nombre, tema, nsfw, modo lento, categoría, posición)
• delete_channel: Elimina un canal
• find_channel: Encuentra el tipo y el ID de un canal usando el nombre y el ID del servidor
• list_channels: Lista de todos los canales
• get_channel_info: Obtén información detallada sobre un canal
• move_channel: Mueve un canal a otra categoría y/o cambia su posición

Gestión de Categorías

• create_category: Crea una nueva categoría para canales
• edit_category: Edita una categoría (renombrar o mover posición)
• delete_category: Elimina una categoría
• find_category: Encuentra el ID de una categoría usando el nombre y el ID del servidor
• list_channels_in_category: Lista de canales en una categoría específica

Gestión de Webhooks

• create_webhook: Crea un nuevo webhook en un canal específico
• delete_webhook: Elimina un webhook
• list_webhooks: Lista de webhooks en un canal específico
• send_webhook_message: Envía un mensaje a través de webhook

Gestión de Roles

• list_roles: Obtén una lista de todos los roles en el servidor con sus detalles
• create_role: Crea un nuevo rol en el servidor
• edit_role: Modifica la configuración de un rol existente
• delete_role: Elimina permanentemente un rol del servidor
• assign_role: Asigna un rol a un usuario
• remove_role: Elimina un rol de un usuario

Moderación y Gestión de Usuarios

• kick_member: Expulsa a un miembro del servidor
• ban_member: Banea a un usuario del servidor
• unban_member: Elimina un baneo de un usuario
• timeout_member: Desactiva la comunicación de un miembro durante una duración específica
• remove_timeout: Elimina un timeout (desmutea) de un miembro antes de que expire
• set_nickname: Cambia el apodo de un miembro en el servidor
• get_bans: Devuelve una lista de usuarios baneados en el servidor con las razones del baneo

Gestión de Canales de Voz y Escenario

• create_voice_channel: Crea un nuevo canal de voz en un servidor
• create_stage_channel: Crea un nuevo canal de escenario para eventos de audio
• edit_voice_channel: Edita la configuración de un canal de voz o escenario (nombre, bitrate, límite de usuarios, región)
• move_member: Mueve a un miembro a otro canal de voz
• disconnect_member: Desconecta a un miembro de su canal de voz actual
• modify_voice_state: Silencia o ensordece a un miembro en canales de voz

Gestión de Eventos Programados

• create_guild_scheduled_event: Programa un nuevo evento en el servidor (voz, escenario o externo)
• edit_guild_scheduled_event: Modifica los detalles del evento o cambia su estado (iniciar, completar, cancelar)
• delete_guild_scheduled_event: Elimina permanentemente un evento programado
• list_guild_scheduled_events: Lista todos los eventos activos y programados en el servidor
• get_guild_scheduled_event_users: Obtén la lista de usuarios interesados en un evento programado

Sobrescrituras de Permisos de Canal

• list_channel_permission_overwrites: Lista todas las sobrescrituras de permisos de un canal con desglose por rol/miembro
• upsert_role_channel_permissions: Crea o actualiza la sobrescritura de permisos para un rol en un canal
• upsert_member_channel_permissions: Crea o actualiza la sobrescritura de permisos para un miembro en un canal
• delete_channel_permission_overwrite: Elimina una sobrescritura de permisos para un rol o miembro de un canal

Gestión de Invitaciones

• create_invite: Crea un nuevo enlace de invitación para un canal específico
• list_invites: Lista todas las invitaciones activas en el servidor con sus estadísticas
• delete_invite: Elimina (revoca) una invitación para que el enlace deje de funcionar
• get_invite_details: Obtén detalles sobre una invitación específica (funciona para cualquier invitación pública)

Gestión de Foros

• create_forum_channel: Crea un nuevo canal de foro
• edit_forum_channel: Edita la configuración de un canal de foro (nombre, tema, nsfw, modo lento, categoría, posición, orden predeterminado, diseño predeterminado)
• list_forum_channels: Lista todos los canales de foro en el servidor
• get_forum_channel_info: Obtén información detallada sobre un canal de foro, incluyendo etiquetas y configuración
• list_forum_tags: Lista todas las etiquetas disponibles en un canal de foro
• create_forum_post: Crea una nueva publicación de foro (hilo) con un mensaje inicial en un canal de foro
• list_forum_posts: Lista las publicaciones activas (hilos) en un canal de foro
• modify_forum_post: Modifica una publicación de foro: bloquear/desbloquear, archivar/desarchivar, fijar/desfijar o cambiar las etiquetas aplicadas

Gestión de Emojis

• list_emojis: Lista todos los emojis personalizados en el servidor
• get_emoji_details: Obtén información detallada sobre un emoji personalizado específico
• create_emoji: Sube un nuevo emoji personalizado al servidor (base64 o URL de imagen, máx. 256KB)
• edit_emoji: Edita el nombre de un emoji existente o las restricciones de rol
• delete_emoji: Elimina permanentemente un emoji personalizado del servidor

Si DISCORD_GUILD_ID está configurado, el parámetro guildId se vuelve opcional para todas las herramientas anteriores.

Puedes encontrar ejemplos más detallados en la Wiki.