discord-mcp

Servidor de Protocolo de Contexto de Modelo (MCP) de nivel de producción que expone la API REST completa de Discord a agentes de IA.

Estado: v0.9.0 · 192 herramientas · Instrumentado con OTel · Resiliente con Cockatiel · Registro de auditoría

Consulta la especificación de diseño para conocer la arquitectura.

Inicio rápido

# 1. Install
npm install -g @discord-mcp/cli  # or use npx

# 2. Bootstrap config for your MCP client
discord-mcp init --client claude-desktop --token "Bot YOUR.BOT.TOKEN"

# 3. Verify configuration
discord-mcp doctor --online

# 4. Run (or let your MCP client launch it)
discord-mcp serve

Subcomandos

discord-mcp serve (predeterminado)

Inicia el servidor MCP stdio. Esta es la acción predeterminada cuando no se proporciona ningún subcomando.

Flags:

• --gateway — Habilita las suscripciones a recursos de Discord Gateway (importación diferida de discord.js)

discord-mcp doctor

Diagnostica la configuración y la conectividad. Sale con 0 (saludable), 1 (advertencias) o 2 (errores).

Flags:

• --online — Ejecuta comprobaciones de red (verificación de token de Discord, accesibilidad de OTel)

• --json — Salida en formato JSON para consumo de CI

Comprobaciones offline: node-version, token-format, env-vars, audit-sink, client-caps Comprobaciones online (con --online): token-online, otel-reachable

discord-mcp init

Configuración de arranque + generación de fragmento de configuración de cliente MCP.

Flags:

• --token <token> — Token del bot de Discord (o marcador de posición ${env:DISCORD_TOKEN})

• --client <id> — Cliente: claude-desktop, claude-code, cursor o generic

• --output <path> — Escribe el fragmento en un archivo (predeterminado: stdout)

• --force — Sobrescribe el archivo de salida existente

• --gateway — Habilita Discord Gateway en la configuración generada

• --json — Salida JSON para CI

Cuando stdin es un TTY y faltan flags, init ejecuta un asistente interactivo.

discord-mcp migrate

Migra desde otra configuración de Discord/MCP. Sale con 0 (todo mapeado), 1 (algunos sin mapear), 2 (errores).

Flags:

• --from <adapter> — ID del adaptador de origen (ejecutar sin --from para listar)

• --source <path> — Ruta al repositorio de origen (predeterminado: cwd)

• --json — Salida JSON

Adaptadores disponibles: hubdustry-go-mcp (implementación de referencia). Más en el Plan 11.

Superficie de herramientas

192 herramientas a través de:

• messages (12)

• channels (14)

• threads (6)

• members (14)

• roles (5)

• guild (16)

• audit_log (1)

• webhooks (13)

• events (6)

• commands (15)

• users (6)

• components-v2 (8)

• intelligence (5)

• meta (1)

• reactions (5)

• emojis (5)

• app_emojis (5)

• stickers (7)

• invites (4)

• automod (5)

• interactions (8)

• application (5)

• stage_instances (4)

• soundboard (7)

• polls (2)

• voice (3)

• onboarding (2)

• monetization (8)

Desarrollo local

Requisitos previos: Node ≥20.11, pnpm ≥9.15.

pnpm install
pnpm build
pnpm test

Prueba de humo (Discord real)

Establece DISCORD_TOKEN con un token de bot real desde https://discord.com/developers/applications:

export DISCORD_TOKEN="Bot YOUR_TOKEN_HERE"
node packages/mcp-server/dist/cli.js

Luego usa el Inspector MCP en otra terminal:

npx -y @modelcontextprotocol/inspector node packages/mcp-server/dist/cli.js

Abre la interfaz de usuario del Inspector en http://localhost:5173, haz clic en tools/list y deberías ver las 192 herramientas.

Documentación

• Operaciones: telemetría — Configuración de OTel

• Operaciones: resiliencia — Ajuste de reintentos/tiempos de espera/circuitos

• Operaciones: auditoría — Receptores de auditoría + cumplimiento

Licencia

MIT — ver LICENSE.