MCP-Discord

Ein Discord MCP-Server (Model Context Protocol), der es KI-Assistenten ermöglicht, mit der Discord-Plattform zu interagieren.

Überblick

MCP-Discord bietet die folgenden Discord-bezogenen Funktionen:

• Beim Discord-Bot anmelden

• Serverinformationen abrufen

• Kanalnachrichten lesen/löschen

• Senden Sie Nachrichten an angegebene Kanäle

• Abrufen von Forum-Kanallisten

• Erstellen/Löschen/Beantworten von Forenbeiträgen

• Textkanäle erstellen/löschen

• Nachrichtenreaktionen hinzufügen/entfernen

• Webhooks erstellen/bearbeiten/löschen/verwenden

Related MCP server: MCP-Discord

Inhaltsverzeichnis

• Voraussetzungen

• Installation

• Konfiguration

• Tools-Dokumentation

  • Grundfunktionen

  • Kanalverwaltung

  • Forumfunktionen

  • Nachrichten und Reaktionen

  • Webhook-Verwaltung

• Entwicklung

• Lizenz

Voraussetzungen

• Node.js (v16.0.0 oder höher)

• npm (v7.0.0 oder höher)

• Ein Discord-Bot mit entsprechenden Berechtigungen

  • Bot-Token (erhältlich im Discord Developer Portal )

  • Nachrichteninhaltsabsicht aktiviert

  • Server Members Intent aktiviert

  • Präsenzabsicht aktiviert

• Berechtigungen auf Ihrem Discord-Server:

  • Nachrichten senden

  • Öffentliche Threads erstellen

  • Senden von Nachrichten in Threads

  • Threads verwalten

  • Kanäle verwalten

  • Reaktionen hinzufügen

Installation

Installation über Smithery

So installieren Sie mcp-discord für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @barryyip0625/mcp-discord --client claude

Manuelle Installation

# Clone the repository
git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord

# Install dependencies
npm install

# Compile TypeScript
npm run build

Konfiguration

Für den ordnungsgemäßen Betrieb ist ein Discord-Bot-Token erforderlich. Sie können es auf zwei Arten bereitstellen:

1. Umgebungsvariablen:

DISCORD_TOKEN=your_discord_bot_token
DEFAULT_SERVER_ID=your_default_server_id  # Optional
DEFAULT_CHANNEL_ID=your_default_channel_id  # Optional

2. Verwenden des Parameters --config beim Starten:

node path/to/mcp-discord/build/index.js --config "{\"DISCORD_TOKEN\":\"your_discord_bot_token\"}"

Verbessertes Startskript

Das Projekt enthält ein verbessertes Startskript ( start-discord.js ), das ein besseres Debugging und eine bessere Fehlerbehandlung ermöglicht:

• Lädt Umgebungsvariablen aus der .env-Datei

• Legt die Standardserver- und Kanal-IDs fest, falls nicht angegeben

• Leitet console.log nach stderr um, um JSON-Analyseprobleme in Claude Desktop zu vermeiden

• Testet die Discord-Verbindung direkt vor dem Start des MCP-Servers

• Bietet detaillierte Fehlerinformationen, wenn etwas schief geht

So verwenden Sie dieses Skript:

node start-discord.js

Verwendung mit Claude/Cursor

• Claude

  {
      "mcpServers": {
          "discord": {
              "command": "node",
              "args": [
                  "path/to/mcp-discord/start-discord.js"
              ],
              "env": {
                  "DISCORD_TOKEN": "your_discord_bot_token",
                  "DEFAULT_SERVER_ID": "your_default_server_id",
                  "DEFAULT_CHANNEL_ID": "your_default_channel_id"
              }
          }
      }
  }

• Cursor

  {
      "mcpServers": {
          "discord": {
              "command": "cmd",
              "args": [
                  "/c",
                  "node",
                  "path/to/mcp-discord/start-discord.js"
              ],
              "env": {
                  "DISCORD_TOKEN": "your_discord_bot_token",
                  "DEFAULT_SERVER_ID": "your_default_server_id",
                  "DEFAULT_CHANNEL_ID": "your_default_channel_id"
              }
           }
       }
  }

Tools-Dokumentation

Grundfunktionen

• discord_login : Bei Discord anmelden

• discord_list_guilds : Listet alle verfügbaren Discord-Server (Gilden) mit ihren Kanälen auf

• discord_send : Senden Sie eine Nachricht an einen angegebenen Kanal

• discord_get_server_info : Discord-Serverinformationen abrufen

Kanalverwaltung

• discord_create_text_channel : Erstelle einen Textkanal

• discord_delete_channel : Einen Kanal löschen

Forumfunktionen

• discord_get_forum_channels : Holen Sie sich eine Liste der Forum-Kanäle

• discord_create_forum_post : Einen Forumsbeitrag erstellen

• discord_get_forum_post : Einen Forumsbeitrag erhalten

• discord_reply_to_forum : Auf einen Forenbeitrag antworten

• discord_delete_forum_post : Einen Forenbeitrag löschen

Nachrichten und Reaktionen

• discord_read_messages : Kanalnachrichten lesen

• discord_add_reaction : Fügen Sie einer Nachricht eine Reaktion hinzu

• discord_add_multiple_reactions : Mehrere Reaktionen auf eine Nachricht hinzufügen

• discord_remove_reaction : Entfernt eine Reaktion aus einer Nachricht

• discord_delete_message : Löscht eine bestimmte Nachricht aus einem Kanal

Webhook-Verwaltung

• discord_create_webhook : Erstellt einen neuen Webhook für einen Discord-Kanal

• discord_send_webhook_message : Sendet eine Nachricht an einen Discord-Kanal unter Verwendung eines Webhooks

• discord_edit_webhook : Bearbeitet einen vorhandenen Webhook für einen Discord-Kanal

• discord_delete_webhook : Löscht einen vorhandenen Webhook für einen Discord-Kanal

Entwicklung

# Development mode
npm run dev

Lizenz

MIT-Lizenz