<p align="center">
  <img src="https://readme-typing-svg.herokuapp.com?font=JetBrains+Mono&size=30&duration=3000&color=5865F2&center=true&vCenter=true&multiline=true&height=50&lines=%F0%9F%A4%96+Discord+MCP+Server;%E2%9C%A8+50+outils+pour+automatiser+Discord" alt="Discord MCP Server">
</p>

<br>

<p align="center">
  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript"></a>
  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white" alt="Node.js"></a>
  <a href="https://discord.js.org/"><img src="https://img.shields.io/badge/Discord.js-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord.js"></a>
  <a href="https://zod.dev/"><img src="https://img.shields.io/badge/Zod-F97316?style=for-the-badge&logo=zod&logoColor=white" alt="Zod"></a>
  <a href="#"><img src="https://img.shields.io/badge/FastMCP-000000?style=for-the-badge&logoColor=white" alt="FastMCP"></a>
</p>

---

## 📖 À 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)**

---

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

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

<details>
<summary>📁 file — Upload / Download de fichiers</summary>

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

</details>

<details>
<summary>💬 message — Gestion des messages</summary>

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

</details>

<details>
<summary>🖼️ embed — Embeds Riches</summary>

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

</details>

<details>
<summary>📝 channel — Canaux</summary>

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

</details>

<details>
<summary>🏷️ role — Rôles</summary>

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

</details>

<details>
<summary>👥 member — Membres</summary>

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

</details>

<details>
<summary>📊 poll — Sondages</summary>

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

</details>

<details>
<summary>🔘 button — Boutons</summary>

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

</details>

<details>
<summary>📋 menu — Menus déroulants</summary>

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

</details>

<details>
<summary>🖥️ server — Serveur</summary>

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

</details>

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

---

## ⚙️ Configuration

### 1. Installation globale

```bash
npm install -g discord-mcp-pro
```

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

```bash
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 :

```env
# 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` |

```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 :

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

### 5. Premier lancement

```bash
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 :

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

### 6. Mise à jour

```bash
npm update -g discord-mcp-pro
```

Pour repasser en local dev :

```bash
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](https://hackmd.io/@1-f9TrSqR0iVfHGkGYO3zw/rk8_YHVQZl)**

### 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](https://discord.gg/4AR82phtBz)
- [📘 Documentation Discord.js](https://discord.js.org/)
- [🔌 Model Context Protocol](https://modelcontextprotocol.io/)
- [📚 Guide Discord Developers](https://discord.com/developers/docs/intro)
- [🤖 Prompt System/Skill pour Discord MCP](https://hackmd.io/@1-f9TrSqR0iVfHGkGYO3zw/rk8_YHVQZl) - _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

---

<div align="center">

**Made with ❤️ by DeaMoN888**

[![GitHub stars](https://img.shields.io/github/stars/yourusername/discord-mcp-server?style=social)](https://github.com/DeamonDev888/-Serveur-Discord-MCP)
[![GitHub forks](https://img.shields.io/github/forks/yourusername/discord-mcp-server?style=social)](https://github.com/DeamonDev888/-Serveur-Discord-MCP)
[![GitHub license](https://img.shields.io/github/license/yourusername/discord-mcp-server)](https://github.com/DeamonDev888/-Serveur-Discord-MCP)

</div>

---

## 📸 Galerie

Voici quelques exemples d'utilisation de Discord MCP Server :

### 🔐 Crypto

![Crypto](assets/crypto.png)

### 🎭 Feux de rôle

![Feux de rôle](assets/feux%20de%20role.png)

### 💻 Aperçu du code

![Code Preview](assets/cod%20preview.png)

### 🍌 Nano Banana

![Nano Banana](assets/nano%20banana.png)

### 📈 Ethereum Price

![Ethereum Price](assets/eth_price.png)