📖 À propos

Imaginez pouvoir contrôler Discord avec votre IA préférée ! 💬

Discord MCP Server est un pont entre votre intelligence artificielle et Discord. Il transforme votre bot Discord en un assistant intelligent capable de comprendre et d'exécuter vos commandes.

🤖 Comment ça marche ?

1. Votre IA envoie une commande
2. Discord MCP Server traduit cette commande pour Discord
3. Votre bot exécute l'action sur votre serveur

🌟 Compatible avec TOUS les assistants IA :

• ✅ Claude Code / Claude Desktop
• ✅ Hermes Agent (Nous Research)
• ✅ OpenClaw / Kilo Code
• ✅ Cursor AI
• ✅ Cline
• ✅ Gemini CLI / Google AI Studio
• ✅ Antigravity
• ✅ Et tous les autres assistants supportant MCP !

En résumé : Parlez à votre IA, et votre bot Discord exécute. C'est aussi simple que ça ! 🚀

Avec 10 outils unifiés avec actions Enum, vous pouvez faire absolument tout sur Discord :

• Envoyer des messages
• Créer des sondages interactifs, menus et boutons
• Gérer votre serveur (Membres, Rôles, Canaux)
• Et bien plus encore !

👉 Consulter la documentation des 10 outils ici

🛠️ Fonctionnalités (10 Outils Unifiés)

Le serveur Discord MCP offre 10 outils unifiés avec actions Enum pour une meilleure organisation :

| Action | Description | |--------|-------------| | upload | Upload un fichier vers Discord (retourne URL CDN) | | download | Télécharge un fichier Discord en local |

| Action | Description | |--------|-------------| | send | Envoie un message texte | | edit | Modifie un message existant | | delete | Supprime un message | | read | Lit l'historique d'un canal | | react | Ajoute une réaction emoji |

| Action | Description | |--------|-------------| | create | Crée un embed avec thèmes, boutons, menus | | list | Liste les embeds d'un canal | | get | Récupère les détails d'un embed | | update | Met à jour un embed existant |

| Action | Description | |--------|-------------| | list | Liste les canaux | | create | Crée un canal | | edit | Modifie un canal | | delete | Supprime un canal | | permissions | Gère les permissions |

| Action | Description | |--------|-------------| | list | Liste les rôles | | create | Crée un rôle | | edit | Modifie un rôle | | delete | Supprime un rôle | | permissions | Gère les permissions |

| Action | Description | |--------|-------------| | list | Liste les membres | | get | Info utilisateur | | kick | Expulse un membre | | ban | Ban un membre | | unban | Débannit | | timeout | Timeout temporaire | | warn | Avertissement | | move | Déplace en vocal | | role | Ajoute/retire rôle |

| Action | Description | |--------|-------------| | create | Crée un sondage interactif | | list | Liste les sondages | | get | Détails d'un sondage | | stop | Arrête un sondage |

| Action | Description | |--------|-------------| | create | Crée un bouton | | register | Lie une fonction JS | | list | Liste les fonctions | | delete | Supprime une fonction |

| Action | Description | |--------|-------------| | create | Crée un menu | | delete | Supprime un menu |

| Action | Description | |--------|-------------| | info | Info serveur | | webhook | Gère les webhooks |

💡 Chaque outil accepte une action action: 'list' | 'create' | 'edit' | 'delete' | 'get' etc. selon l'outil.

⚙️ Configuration

1. Installation globale

npm install -g discord-mcp-pro

Le package installe automatiquement un binaire discord-mcp dans votre PATH. Lancez-le simplement :

discord-mcp

💡 Au premier install, un message d'aide complet s'affiche (création du bot, .env, configuration MCP). Pas besoin de revenir ici.

2. Créer un bot Discord

1. Allez sur https://discord.com/developers/applications
2. New Application → donnez-lui un nom
3. Bot section → Add Bot → copiez le Token (c'est votre DISCORD_TOKEN)
4. Activez les Privileged Gateway Intents :
   • ✅ Server Members Intent
   • ✅ Message Content Intent
5. OAuth2 → URL Generator :
   • Scopes : bot, applications.commands
   • Bot Permissions : Administrator (ou granular si vous savez ce que vous faites)
   • Ouvrez l'URL générée pour inviter le bot

3. Variables d'environnement

Créez un fichier .env (le wrapper discord-mcp cherche automatiquement dans cet ordre) :

| Priorité | Localisation | Usage | |---|---|---| | 1 | ./.env (cwd) | Override local, idéal pour tests | | 2 | $HOME/.env | Config globale partagée | | 3 | <pkg dir>/.env | Config système |

Contenu minimum :

# Token Discord du bot (obligatoire)
DISCORD_TOKEN=your-bot-token-here

# Guild ID (optionnel, recommandé pour limiter les opérations serveur)
DISCORD_GUILD_ID=123456789012345678

Variables complètes (voir .env.example à la racine du repo) :

| Variable | Obligatoire | Description | |---|---|---| | DISCORD_TOKEN | ✅ Oui | Token du bot (https://discord.com/developers) | | DISCORD_GUILD_ID | Non | Limite les opérations à un serveur spécifique | | DISCORD_CLIENT_ID | Non | Pour OAuth flow | | ADMIN_USER_ID | Non | Restreint les commandes admin à cet utilisateur | | BOT_PREFIX | Non | Préfixe des commandes texte (défaut: !) | | LOG_LEVEL | Non | info / debug / warn / error |

4. Wire to your MCP client

Le serveur MCP écoute par défaut sur http://localhost:3141/mcp.

Claude Desktop

Éditez votre fichier de config MCP :

| OS | Chemin | |---|---| | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Linux | ~/.config/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json |

{
  "mcpServers": {
    "discord": {
      "command": "discord-mcp",
      "args": []
    }
  }
}

💡 Pourquoi "command": "discord-mcp" plutôt qu'un chemin absolu ? Parce que npm install -g ajoute le binaire à votre PATH automatiquement. Si vous avez installé via npm, cette config marche partout, multi-OS, sans chemin codé en dur.

Hermes / Kilo / Cline / Cursor / autres

Même format JSON dans leur config respective :

{
  "mcpServers": {
    "discord": {
      "command": "discord-mcp",
      "args": [],
      "env": {
        "DISCORD_TOKEN": "${env:DISCORD_TOKEN}",
        "DISCORD_GUILD_ID": "${env:DISCORD_GUILD_ID}"
      }
    }
  }
}

5. Premier lancement

discord-mcp

Vous devriez voir :

[INFO] [serveur_discord] === DÉBUT ENREGISTREMENT DES OUTILS EMBEDS ===
[INFO] [serveur_discord] Ajout de l'outil creer_embed...
...
✓ discord-mcp-pro ready (17 tools, http://localhost:3141/mcp)

Si vous voyez Cannot find dist/index.js, réinstallez avec :

npm install -g discord-mcp-pro --force

6. Mise à jour

npm update -g discord-mcp-pro

Pour repasser en local dev :

git clone https://github.com/DeamonDev888/-Serveur-Discord-MCP.git
cd -Serveur-Discord-MCP
npm install
npm run build
npm run dev

💡 Cas d'usage

Avec Discord MCP Server, vous pouvez :

• 💬 Automatiser les messages de bienvenue
• 📊 Créer des sondages interactifs
• 🎨 Générer des embeds magnifiques
• 📋 Modérer votre serveur
• 🔔 Configurer des webhooks pour les notifications
• 🎮 Créer des boutons pour les commandes rapides
• 📈 Surveiller l'activité du serveur
• 🤖 Créer un bot IA qui répond à TOUT - Le bot ultime qui peut :
  • Répondre aux questions des membres
  • Aider à la modération automatiquement
  • Animer le serveur avec des jeux et quiz
  • Donner des informations en temps réel
  • Apprendre et s'adapter à votre communauté
  • Interagir avec tous les services externes (API, bases de données, etc.)

🤖 Prompt System Optimisé

Pour exploiter pleinement les 50 outils de Discord MCP Server, utilisez le prompt système dédié :

👉 Accéder au prompt ou skill système ici

Qu'est-ce que c'est ?

Un prompt système spécialement conçu pour permettre à votre IA de :

• 🎯 Utiliser automatiquement les bons outils Discord selon vos demandes
• 🔧 Comprendre les interactions complexes (boutons, menus, sondages)
• 📋 Générer des réponses adaptées à chaque contexte Discord
• 🚀 Optimiser l'utilisation des 50 outils disponibles

Comment l'utiliser ?

1. Copiez le prompt système depuis le lien ci-dessus
2. Collez-le dans votre système de prompt (Claude, ChatGPT, etc.)
3. Discutez normalement - l'IA choisira automatiquement les bons outils Discord

Exemple : "Envoie un message de bienvenue avec des boutons interactifs dans le channel #général"

L'IA utilisera automatiquement les outils :

• get_channels pour trouver le channel
• envoyer_message pour le message
• create_custom_buttons pour les boutons

📚 Documentation

• 🎮 Serveur Discord
• 📘 Documentation Discord.js
• 🔌 Model Context Protocol
• 📚 Guide Discord Developers
• 🤖 Prompt System/Skill pour Discord MCP - Prompt système optimisé pour exploiter tous les outils Discord MCP

🤝 Contribuer

Les contributions sont les bienvenues ! N'hésitez pas à :

• ⭐ Mettre une étoile au projet
• 🐛 Signaler des issues
• 💡 Proposer des améliorations
• 🔧 Envoyer des pull requests

Made with ❤️ by DeaMoN888

📸 Galerie

Voici quelques exemples d'utilisation de Discord MCP Server :

🔐 Crypto

🎭 Feux de rôle

💻 Aperçu du code

🍌 Nano Banana

📈 Ethereum Price