Discord MCP by Quadslab.io

@quadslab.io/discord-mcp

Gestiona todo tu servidor de Discord desde Claude Code, Claude Co-Work, Claude Desktop, Cursor o Windsurf. 139 herramientas de administración en 20 categorías: roles, canales, miembros, mensajes, hilos, moderación, foros, escenarios, webhooks, eventos, encuestas, mensajes directos y más. Solo habla con tu IA en lenguaje natural.

Creado por QuadsLab.io | Discord | npm

Si te resulta útil, considera darle una estrella en GitHub: ¡ayuda a que otros descubran el proyecto!

Configuración en 60 segundos

Un solo comando. Sin archivos de configuración manuales. Sin copiar IDs.

npx @quadslab.io/discord-mcp init

El asistente interactivo te guía paso a paso:

Hará lo siguiente:

1. Te guiará para crear un bot de Discord (o usar uno existente)
2. Validará tu token de bot en vivo
3. Generará automáticamente la URL de invitación con todos los permisos necesarios
4. Te permitirá elegir qué servidor administrar
5. Detectar automáticamente tus clientes MCP instalados y escribirá la configuración por ti

Funciona con todos los clientes MCP

El asistente detecta automáticamente qué clientes tienes instalados:

  Detected MCP clients:

  ● Claude Code      .mcp.json
  ● Claude Desktop   ~/Library/Application Support/Claude/claude_desktop_config.json
  ● Cursor           ~/.cursor/mcp.json
  ○ Windsurf         (not detected)

  ? Which client(s) to configure?
  1. Claude Code (detected)
  2. Claude Desktop (detected)
  3. Cursor (detected)
  4. Windsurf (not found)
  5. All detected (3 clients)
  6. Skip (show config to copy manually)

Selecciona uno, varios o "Todos los detectados" para configurar todo a la vez.

Verifica tu configuración

npx @quadslab.io/discord-mcp check

  QuadsLab.io [discord-mcp] — Health Check
  ────────────────────────────────────────────────────

  Token ............ present
  Bot .............. MyBot#1234
  Server ........... My Gaming Server (1,024 members)

  Permissions
  ────────────────────────────────────────────────────

  ✔ Manage Roles .............. yes
  ✔ Manage Channels ........... yes
  ✔ Kick Members .............. yes
  ✔ Ban Members ............... yes
  ...

  ██████████████████████████████  100% (24/24)

  ✔ All 24 permissions granted

  ┌──────────────────────────────────────────────────┐
  │ MCP server is ready!                             │
  │ Run discord-mcp or use via .mcp.json in Claude   │
  └──────────────────────────────────────────────────┘

¿Qué puedes hacer con esto?

Una vez conectado a Claude Code o Claude Co-Work, solo pregunta en lenguaje natural:

• "Envía un mensaje de bienvenida en #general"
• "Bloquea el canal #anuncios"
• "¿Quién reaccionó al último mensaje en #guía-del-servidor?"
• "Crea un rol llamado VIP con color dorado y asígnalo a @john"
• "Muéstrame el registro de auditoría de las últimas 24 horas"
• "Configura una regla de automoderación para bloquear enlaces en #general"
• "Muéstrame los últimos 20 mensajes en el hilo 'Discusión de API'"
• "Envía una respuesta en el hilo 'reporte-de-error' diciendo que lo estamos investigando"
• "Lista todos los hilos archivados en #general"
• "Crea una publicación en el foro #comentarios titulada Reportes de errores"
• "Aplica un tiempo de espera a @spammer por 1 hora por spam"
• "Lista todos los webhooks y elimina los que no se usan"
• "Programa un evento comunitario para el viernes a las 8pm en el canal de escenario"
• "Elimina en masa los últimos 50 mensajes en #pruebas-de-bot"
• "Dale a todos los que tengan el rol Miembro acceso a #canal-privado"
• "Crea una encuesta en #general preguntando qué juego jugar el viernes"
• "Envía un mensaje directo a todos los moderadores sobre el próximo evento del servidor"
• "Establece el estado del bot como 'Vigilando a más de 500 miembros'"
• "Muéstrame quién está en el canal de voz Gaming ahora mismo"

Claude resuelve automáticamente los nombres de canales, roles y miembros mediante coincidencia difusa: no necesitas buscar IDs.

Características

• 139 herramientas en 20 categorías: administración integral del servidor de Discord sin salir de la terminal
• Asistente de configuración interactivo: npx init te guía en la creación del bot, validación del token y configuración en menos de un minuto
• Verificación de estado y auditoría de permisos: npx check verifica tu token, acceso al servidor y los 24 permisos requeridos con una barra de progreso visual
• Resolución difusa de nombres: escribe "bot testing", "bot-testing" o "bottesting" y se resuelve correctamente; no necesitas buscar IDs
• Mensajería compatible con hilos: todas las herramientas de mensajes (enviar, editar, fijar, reaccionar, etc.) funcionan tanto en hilos como en canales: no se necesitan herramientas separadas
• Coincidencia de nombres sin configuración: canales, roles y miembros se resuelven automáticamente por nombre, ID o formato de mención
• Datos del servidor precargados: todos los canales, roles y miembros se almacenan en caché al inicio para búsquedas instantáneas sin llamadas API adicionales
• Respuestas JSON estructuradas: cada herramienta devuelve JSON consistente y bien formateado
• Integración con registro de auditoría: todas las operaciones de modificación aceptan un parámetro reason que aparece en el registro de auditoría de Discord
• Recuperación de errores útil: las búsquedas fallidas devuelven sugerencias (por ejemplo, "¿Quisiste decir: #general, #pruebas-de-bot?")
• Recursos MCP: tres recursos de solo lectura para datos de descripción general del servidor

Configuración alternativa (manual)

Si prefieres configurar las cosas manualmente en lugar de usar el asistente:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@quadslab.io/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "your-bot-token",
        "DISCORD_GUILD_ID": "your-server-id"
      }
    }
  }
}

git clone https://github.com/HardHeadHackerHead/discord-mcp.git
cd discord-mcp
npm install
cp .env.example .env
# Edit .env with your DISCORD_TOKEN and DISCORD_GUILD_ID
npm run build
npm start

Referencia de CLI

$ npx @quadslab.io/discord-mcp [command]

Cuando se inicia mediante .mcp.json (stdin no es un TTY), el servidor se inicia automáticamente: no se necesita ningún subcomando.

Actualización

La configuración de tu cliente MCP no fija una versión, por lo que actualizar es simple:

npx @quadslab.io/discord-mcp update

Esto busca la última versión en npm, limpia la caché de npx, y tu próximo lanzamiento del cliente MCP usará la nueva versión automáticamente. Tu token de bot, servidor y configuración de cliente se conservan: no es necesario reconfigurar nada.

Para verificar después de actualizar:

npx @quadslab.io/discord-mcp version
npx @quadslab.io/discord-mcp check

Descripción general de herramientas

Resumen

Coincidencia difusa

Todas las herramientas que aceptan nombres de canales, roles o miembros utilizan coincidencia difusa inteligente. Nunca necesitas buscar IDs manualmente. El orden de resolución es:

1. Coincidencia exacta de ID — pasa un ID de copo de nieve de Discord directamente
2. Coincidencia exacta de nombre — sin distinción de mayúsculas y minúsculas
3. Coincidencia normalizada — ignora guiones, espacios y guiones bajos ("bot testing" coincide con "bot-testing")
4. Coincidencia de subcadena — coincidencias parciales de nombre con un umbral de similitud de 0.7 o superior
5. Respaldo de hilos — si no coincide ningún canal, se buscan hilos activos usando los mismos pasos anteriores
6. Respaldo de hilos archivados — si se proporciona un ID y no se encuentra en hilos activos, el hilo se obtiene directamente (cubre hilos archivados)

Los formatos de mención también se manejan automáticamente:

• Canales: #name o <#id>
• Roles: @name o <@&id>
• Miembros: @name o <@id> o <@!id>

Si no se encuentra ninguna coincidencia, el mensaje de error incluye sugerencias de nombres similares para ayudarte a corregir la entrada.

Recursos MCP

Se exponen tres recursos de solo lectura para obtener una vista rápida de los datos del servidor:

Permisos requeridos

El bot de Discord necesita los siguientes permisos para un funcionamiento completo:

El asistente init genera automáticamente una URL de invitación con todos estos. Si configuras manualmente, consulta la Guía de configuración del bot para saber qué casillas seleccionar.

El bot solo puede actuar dentro de su jerarquía de roles: no puede gestionar roles que estén por encima de su rol más alto.

Intenciones de puerta de enlace

Estas intenciones privilegiadas deben habilitarse en el Portal de desarrolladores de Discord:

• Intención de miembros del servidor — requerida para la gestión de miembros
• Intención de contenido de mensajes — requerida para leer el contenido de los mensajes

Solución de problemas

Ejecuta la comprobación de salud para diagnosticar problemas:

npx @quadslab.io/discord-mcp check

npx @quadslab.io/discord-mcp@latest init

Arquitectura

@quadslab.io/discord-mcp/
├── package.json
├── tsconfig.json
├── README.md
├── LICENSE
├── .env.example
├── docs/
│   ├── discord-mcp-server.md    # Full tool reference documentation
│   └── bot-setup-guide.md       # Step-by-step bot creation guide
└── src/
    ├── cli.ts                   # CLI — init wizard, health check, server start
    ├── mcp-server.ts            # MCP server entry — validates env, exports main()
    ├── index.ts                 # Tool/resource registration and MCP request routing
    ├── discord-client.ts        # Discord.js client — intents, caching, rate limit retry
    └── tools/
        ├── index.ts             # Tool registry — routes calls to category handlers
        ├── utils.ts             # Fuzzy matching for channels, roles, members
        ├── guild.ts             # Server info (2)
        ├── roles.ts             # Role management (11)
        ├── channels.ts          # Channel management (20)
        ├── members.ts           # Member management (15)
        ├── messages.ts          # Messaging (14)
        ├── reactions.ts         # Reactions (1)
        ├── server.ts            # Server admin (16)
        ├── threads.ts           # Thread management (15)
        ├── forums.ts            # Forum channels (5)
        ├── emojis.ts            # Emoji & stickers (7)
        ├── webhooks.ts          # Webhooks (4)
        ├── events.ts            # Scheduled events (5)
        ├── stage.ts             # Stage instances (3)
        ├── automod.ts           # Auto-moderation (4)
        ├── polls.ts             # Polls (3)
        ├── dms.ts               # Direct messages (2)
        ├── presence.ts          # Bot presence (2)
        ├── templates.ts         # Server templates (4)
        ├── commands.ts          # Application commands (4)
        └── onboarding.ts        # Onboarding (2)

Comunidad

• Servidor de Discord — obtén ayuda, comparte comentarios, mira lo que otros están construyendo
• Problemas de GitHub — informes de errores y solicitudes de funciones
• Discusiones de GitHub — preguntas, ideas y muestra y cuenta
• QuadsLab.io — más herramientas del equipo

Contribuciones

¡Las contribuciones son bienvenidas! Consulta CONTRIBUTING.md para la configuración de desarrollo, estilo de código y pautas.

Licencia

Licencia MIT. Copyright (c) 2026 QuadsLab.io.

Consulta LICENSE para el texto completo.