/ Annuaire / Playground / discord-mcp
● Communauté SaseQ ⚡ Instantané

discord-mcp

par 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.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

discord-mcp-2.replay ▶ prêt
0/0

Installer

Choisissez votre client

~/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"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : discord-mcp

How to automate Discord server moderation with discord-mcp

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

Quand l'utiliser : You want to perform bulk moderation actions or set up automated responses.

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

Résultat : Spam cleaned up and violators timed out in one operation.

Pièges
  • 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

Quand l'utiliser : You need to create channels, roles, and scheduled events for a community meetup or tournament.

Prérequis
  • Discord bot with Manage Channels and Manage Events permissions — Set up via discord.com/developers
Déroulement
  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.✓ Copié
    → 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.'✓ Copié
    → 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.✓ Copié
    → Role created and assigned

Résultat : Complete event setup with channels, scheduled event, and participant roles.

Pièges
  • Channel permission overwrites are complex — Set permissions at the category level and let channels inherit them

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

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.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
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

Coût et limites

Coût d'exécution

Quota d'API
Discord bot rate limits apply (varies by endpoint, typically 5-50 req/s)
Tokens par appel
200–800 tokens per tool call
Monétaire
Free — Discord bot API is free
Astuce
Batch read operations when possible. Use server_id env var to restrict to one server.

Sécurité

Permissions, secrets, portée

Portées minimales : Bot token with required permissions
Stockage des identifiants : Bot token in environment variable. Never commit bot tokens to repos.
Sortie de données : All calls go to Discord API (discord.com)
Ne jamais accorder : Administrator permission to the bot unless absolutely necessary

Dépannage

Erreurs courantes et correctifs

403 Missing Permissions

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

Vérifier : 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.

Vérifier : 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.

Vérifier : docker logs <container-name>

Alternatives

discord-mcp vs autres

AlternativeQuand l'utiliserCompromis
slack-mcp-serverYour team uses Slack instead of DiscordDifferent platform, similar feature coverage

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills