Discord MCP 服务器

Discord MCP Server 是一个连接AI助手与Discord的桥梁,可将AI命令转换为Discord操作,提供10种统一工具支持消息管理、频道管理、角色管理等功能。

  • by DeamonDev888
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 DeamonDev888/-Serveur-Discord-MCP

使用说明



📖 À 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 :

📁 file — Upload / Download de fichiers
Action Description
upload Upload un fichier vers Discord (retourne URL CDN)
download Télécharge un fichier Discord en local
💬 message — Gestion des messages
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
🖼️ embed — Embeds Riches
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
📝 channel — Canaux
Action Description
list Liste les canaux
create Crée un canal
edit Modifie un canal
delete Supprime un canal
permissions Gère les permissions
🏷️ role — Rôles
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
👥 member — Membres
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
📊 poll — Sondages
Action Description
create Crée un sondage interactif
list Liste les sondages
get Détails d'un sondage
stop Arrête un sondage
🔘 button — Boutons
Action Description
create Crée un bouton
register Lie une fonction JS
list Liste les fonctions
delete Supprime une fonction
📋 menu — Menus déroulants
Action Description
create Crée un menu
delete Supprime un menu
🖥️ server — Serveur
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


🤝 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