/ Directorio / Playground / discord-mcp
● Comunidad SaseQ ⚡ Instantáneo

discord-mcp

por SaseQ · SaseQ/discord-mcp

Full Discord server management from AI — messages, channels, roles, moderation, events, webhooks, and voice channels.

discord-mcp is a Java-based MCP server built on JDA (Java Discord API) that gives AI assistants full control over Discord servers. It exposes 44+ tools covering messaging, channel management, role administration, moderation (kick/ban/timeout), voice channels, scheduled events, webhooks, and emoji management. Supports Docker deployment with both HTTP and stdio transport.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

discord-mcp-2.replay ▶ listo
0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "discord-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/SaseQ/discord-mcp"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "discord-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/SaseQ/discord-mcp"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "discord-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/SaseQ/discord-mcp"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "discord-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/SaseQ/discord-mcp"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "discord-mcp-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/SaseQ/discord-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "discord-mcp-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/SaseQ/discord-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add discord-mcp-2 -- TODO 'See README: https://github.com/SaseQ/discord-mcp'

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: discord-mcp

How to automate Discord server moderation with discord-mcp

👤 Discord server moderators and community managers ⏱ ~10 min beginner

Cuándo usarlo: You want to perform bulk moderation actions or set up automated responses.

Requisitos previos
  • Discord bot token — Create a bot at discord.com/developers and invite it to your server with appropriate permissions
Flujo
  1. Review recent activity
    Show me the last 50 messages in #general. Flag any that contain spam links or rule violations.✓ Copiado
    → Message list with flagged items highlighted
  2. Take moderation action
    Delete the flagged messages and timeout the users who posted them for 24 hours.✓ Copiado
    → Confirmation of deletions and timeouts applied

Resultado: Spam cleaned up and violators timed out in one operation.

Errores comunes
  • Bot lacks required permissions — Ensure the bot role has Manage Messages, Moderate Members, and other needed permissions

Set up event channels and scheduled events for your community

👤 Community organizers running Discord-based events ⏱ ~15 min intermediate

Cuándo usarlo: You need to create channels, roles, and scheduled events for a community meetup or tournament.

Requisitos previos
  • Discord bot with Manage Channels and Manage Events permissions — Set up via discord.com/developers
Flujo
  1. Create event infrastructure
    Create a new category called 'Game Night March 2025' with text channels #announcements, #general-chat, and #voice-lobby. Also create a voice channel.✓ Copiado
    → Channels created with confirmations
  2. Schedule the event
    Create a scheduled event for 'Game Night' this Saturday at 8pm EST in the voice-lobby channel. Description: 'Weekly game night! Join us for Among Us and Jackbox.'✓ Copiado
    → Scheduled event created with link
  3. Create a role for participants
    Create a 'Game Night Crew' role with a green color and assign it to @user1, @user2, and @user3.✓ Copiado
    → Role created and assigned

Resultado: Complete event setup with channels, scheduled event, and participant roles.

Errores comunes
  • Channel permission overwrites are complex — Set permissions at the category level and let channels inherit them

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

discord-mcp-2 + github

Post GitHub PR notifications to a Discord channel automatically

Check for new merged PRs in our repo since yesterday and post a summary to #dev-updates on Discord.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
send_message channel_id: str, content: str Send a message to a Discord channel 1 Discord API call
read_messages channel_id: str, limit?: int Read message history from a channel 1 Discord API call
create_text_channel name: str, category_id?: str Create a new text channel 1 Discord API call
kick_member user_id: str, reason?: str Kick a member from the server 1 Discord API call
create_scheduled_event name, start_time, channel_id, description? Schedule a server event 1 Discord API call
create_role name: str, color?: str, permissions?: int Create a new role on the server 1 Discord API call

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Discord bot rate limits apply (varies by endpoint, typically 5-50 req/s)
Tokens por llamada
200–800 tokens per tool call
Monetario
Free — Discord bot API is free
Consejo
Batch read operations when possible. Use server_id env var to restrict to one server.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Bot token with required permissions
Almacenamiento de credenciales: Bot token in environment variable. Never commit bot tokens to repos.
Salida de datos: All calls go to Discord API (discord.com)
No conceder nunca: Administrator permission to the bot unless absolutely necessary

Resolución de problemas

Errores comunes y soluciones

403 Missing Permissions

The bot lacks the required permission for this action. Check the bot's role permissions in Server Settings → Roles.

Verificar: Review the bot's role permissions in Discord server settings
Unknown Channel / 404

The channel ID is incorrect or the bot doesn't have access to that channel. Verify the channel exists and the bot can see it.

Verificar: List channels with channels_list tool first
Docker container can't connect

Ensure the DISCORD_TOKEN environment variable is set correctly in your docker-compose.yml or docker run command.

Verificar: docker logs <container-name>

Alternativas

discord-mcp vs otros

AlternativaCuándo usarlaContrapartida
slack-mcp-serverYour team uses Slack instead of DiscordDifferent platform, similar feature coverage

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills