discord-mcp

@spranab/discord-mcp

Moderar un servidor de Discord significa hacer clic: abrir el servidor, encontrar el canal, desplazarse hasta el mensaje, abrir la lista de miembros, aplicar el tiempo de espera, escribir la nota en algún lugar. Cada servidor MCP de Discord que expone una herramienta por operación también te cuesta miles de tokens de contexto antes de que el modelo lea tu pregunta.

Este le da a un asistente de IA todo el servidor — más de 30 acciones en mensajes, canales, roles, miembros, moderación, hilos, webhooks, invitaciones, emojis y el registro de auditoría — detrás de una única herramienta discord con descubrimiento de tres niveles, para que el modelo pague solo por las acciones que usa y nada más.

Instalación (60 segundos)

Claude Code — agrégalo a tu .mcp.json:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@spranab/discord-mcp"],
      "env": { "bot_token": "YOUR_BOT_TOKEN" }
    }
  }
}

¿Necesitas un token de bot? Consulta Configuración del Bot de Discord a continuación — aproximadamente dos minutos en el Portal de Desarrolladores.

Cómo se ve

Tú: "Alguien está enviando spam en #general. Borra los últimos 20 mensajes allí, aplica tiempo de espera a ese usuario por una hora y regístralo para los moderadores."

→ discord(category: "messages", action: "bulk_delete",
          params: { channel_id: "9876...", count: 20 })
→ discord(category: "moderation", action: "timeout",
          params: { guild_id: "1234...", user_id: "5555...",
                    duration_minutes: 60, reason: "Spam in #general" })
→ discord(category: "messages", action: "send",
          params: { channel_id: "4321...",
                    content: "Timed out spammer (1h), cleared 20 messages in #general" })

El modelo encontró bulk_delete y timeout llamando a discord() y luego discord(category: "moderation") — nunca tuvo más de 30 esquemas de herramientas en su prompt. Los IDs de canal y usuario provienen de channels: list y members: list de la misma manera.

Características

Una herramienta discord con 11 categorías y más de 30 acciones:

Categoría	Acciones	Descripción
servidor	list, info	Listar servidores, obtener detalles del servidor
canales	list, create, edit, delete	Gestión completa de canales
mensajes	send, read, edit, delete, bulk_delete, pin, react, search	Enviar, leer, moderar mensajes
roles	list, create, edit, delete, assign	CRUD de roles + asignación
miembros	list, info, nickname	Listado y gestión de miembros
moderación	kick, ban, unban, timeout, list_bans	Moderación del servidor
hilos	create	Creación de hilos
webhooks	list, create	Gestión de webhooks
invitaciones	create, list	Gestión de invitaciones
emojis	list	Listado de emojis personalizados
auditoría	log	Acceso al registro de auditoría

Cómo funciona

La herramienta usa navegación de 3 niveles para mantener tu lista de herramientas limpia:

discord()                                          → list categories
discord(category="messages")                       → list actions & params
discord(category="messages", action="send", params={...}) → execute

Otros clientes

Misma forma JSON para Cursor, Windsurf, Claude Desktop y Cline:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@spranab/discord-mcp"],
      "env": {
        "bot_token": "YOUR_BOT_TOKEN"
      }
    }
  }
}

Manual

npm install -g @spranab/discord-mcp

Ejecuta con la variable de entorno bot_token configurada:

bot_token=YOUR_BOT_TOKEN discord-mcp

Configuración del Bot de Discord

1. Ve al Portal de Desarrolladores de Discord
2. Crea una nueva aplicación
3. Ve a Bot y copia el token
4. Habilita Privileged Gateway Intents (los tres):
   • Presence Intent
   • Server Members Intent
   • Message Content Intent
5. Ve a Installation > Default Install Settings > Guild Install
6. Agrega el alcance bot y selecciona los permisos Administrator
7. Usa el enlace de instalación para agregar el bot a tu servidor

Stack tecnológico

• TypeScript
• discord.js v14
• MCP SDK
• Zod para validación

Proyectos relacionados

Otros servidores MCP e infraestructura de agentes del mismo autor:

• saga-mcp — rastreador de proyectos respaldado por SQLite para que el agente no pierda el plan entre sesiones.
• yantrikdb-mcp — memoria cognitiva persistente para Claude Code, Cursor y Windsurf.
• truenas-mcp — 278 acciones de TrueNAS SCALE detrás del mismo patrón de una sola herramienta usado aquí.
• brainstorm-mcp — debate multimodelo como herramienta MCP.
• swarmcode — canal en tiempo real entre instancias de Claude Code en diferentes máquinas.

Licencia

MIT — consulta LICENSE.