MCP-Discord

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

Übersicht

MCP-Discord bietet die folgenden Discord-bezogenen Funktionen:

• Anmeldung bei einem Discord-Bot

• Auflisten der Server, auf denen der Bot Mitglied ist

• Abrufen von Serverinformationen

• Auflisten von Mitgliedern und Einsehen von Mitgliedsdetails

• Auflisten, Erstellen, Bearbeiten, Löschen, Zuweisen und Entfernen von Rollen

• Suchen von Nachrichten auf einem Server

• Lesen, Bearbeiten und Löschen von Kanalnachrichten

• Senden von Nachrichten an bestimmte Kanäle

• Abrufen von Forenkanallisten

• Erstellen, Aktualisieren, Löschen und Beantworten von Forenbeiträgen

• Auflisten von Foren-Threads und Verwalten von Foren-Tags

• Erstellen, Bearbeiten und Löschen von Text-, Foren-, Sprachkanälen und Kategorien

• Festlegen und Entfernen von Kanalberechtigungs-Overrides

• Hinzufügen/Entfernen von Nachrichtenreaktionen

• Erstellen/Bearbeiten/Löschen/Verwenden von Webhooks

Related MCP server: MCP-Discord

Inhaltsverzeichnis

• Voraussetzungen

• Installation

• Konfiguration

• Tool-Dokumentation

  • Grundlegende Funktionen

  • Kanalverwaltung

  • Forenfunktionen

  • Nachrichten und Reaktionen

  • Webhook-Verwaltung

  • Rollenverwaltung

  • Mitgliederverwaltung

• Entwicklung

• Lizenz

Voraussetzungen

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

• npm (v7.0.0 oder höher)

• Ein Discord-Bot mit entsprechenden Berechtigungen

  • Bot-Token (erhältlich über das Discord Developer Portal)

  • Message Content Intent aktiviert

  • Server Members Intent aktiviert

  • Presence Intent aktiviert

• Erforderliche Berechtigungen auf Ihrem Discord-Server:

  Einfachste Einrichtung

  • Administrator (Empfohlen für eine schnelle Einrichtung und volle Funktionalität)

  Oder wählen Sie nur die erforderlichen Berechtigungen aus:

  • Nachrichten senden

  • Öffentliche Threads erstellen

  • Nachrichten in Threads senden

  • Nachrichten verwalten

  • Threads verwalten

  • Kanäle verwalten

  • Webhooks verwalten

  • Rollen verwalten

  • Reaktionen hinzufügen

  • Kanal anzeigen

• Fügen Sie Ihren Discord-Bot Ihrem Server hinzu

  • Um Ihren Discord-Bot Ihrem Server hinzuzufügen, verwenden Sie einen der folgenden Einladungslinks (ersetzen Sie INSERT_CLIENT_ID_HERE durch die Client-ID Ihres Bots):

    • Administrator (vollständiger Zugriff): https://discord.com/oauth2/authorize?client\\\\_id=INSERT\\\\_CLIENT\\\\_ID\\\\_HERE\\\\&scope=bot\\\\&permissions=8

    • Benutzerdefinierte Berechtigungen (erforderliches Minimum): https://discord.com/oauth2/authorize?client\\\\_id=INSERT\\\\_CLIENT\\\\_ID\\\\_HERE\\\\&scope=bot\\\\&permissions=52076489808

Hinweis:
Gemäß dem Sicherheitsmodell von Discord kann ein Bot nur auf Informationen von Servern zugreifen, denen er explizit hinzugefügt wurde.
Wenn Sie diesen MCP-Server verwenden möchten, um auf einen bestimmten Discord-Server zuzugreifen, müssen Sie den Bot zuerst diesem Server hinzufügen.
Verwenden Sie den unten stehenden Einladungslink, um den Bot Ihrem Zielserver hinzuzufügen.

Installation

Installation via NPM

Sie können es mit dem folgenden Befehl verwenden:

npx mcp-discord --config ${DISCORD_TOKEN}

Weitere Details finden Sie im NPM-Paket.

Installation via Smithery

Um mcp-discord automatisch über Smithery zu installieren

Installation via Docker

Sie können mcp-discord mit Docker ausführen. Die Docker-Images werden automatisch erstellt und auf Docker Hub veröffentlicht.

Docker Hub Repository: barryy625/mcp-discord

Docker verwendet standardmäßig den streamfähigen HTTP-Server über build/app.js.

# Pull the latest image
docker pull barryy625/mcp-discord:latest

# Run HTTP server on port 8080
docker run -e DISCORD_TOKEN=your_discord_bot_token -p 8080:8080 barryy625/mcp-discord:latest

# Override the listening port if needed
docker run -e DISCORD_TOKEN=your_discord_bot_token -p 3000:3000 barryy625/mcp-discord:latest --transport http --port 3000

Verfügbare Tags:

• latest - Neueste stabile Version aus dem Haupt-Branch

• v1.3.8, etc. - Spezifische Versions-Releases

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. Der Server unterstützt zwei Transportmethoden: stdio und streamfähiges HTTP.

Transportmethoden

1. stdio (Standard)

   • Traditioneller stdio-Transport für die grundlegende Nutzung

   • Geeignet für einfache Integrationen

2. streamfähiges HTTP

   • HTTP-basierter Transport für fortgeschrittenere Szenarien

   • Unterstützt zustandslosen Betrieb

   • Konfigurierbare Portnummer

Konfigurationsoptionen

Sie können die Konfiguration auf zwei Arten bereitstellen:

1. Umgebungsvariablen:

DISCORD_TOKEN=your_discord_bot_token

2. Verwendung von Befehlszeilenargumenten:

# For stdio transport (default)
node build/index.js --config "your_discord_bot_token"

# For streamable HTTP transport
node build/app.js --transport http --port 3000 --config "your_discord_bot_token"

Verwendung mit Claude/Cursor

1. Verwendung des Stdio-Transports mit Claude/Cursor

Verwenden Sie build/index.js, wenn Ihr MCP-Client einen befehlsbasierten Stdio-Server erwartet.

Claude Desktop / Claude Code

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token"
            }
        }
    }
}

Cursor

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token"
            }
        }
    }
}

Dies ist die empfohlene Einrichtung für lokale befehlsbasierte MCP-Clients.

2. Selbst-Hosting des streamfähigen HTTP-Servers

Verwenden Sie build/app.js, wenn Sie mcp-discord als HTTP-MCP-Server ausführen möchten.

Ausführen mit Node.js

DISCORD_TOKEN=your_discord_bot_token node build/app.js --transport http --port 3000

Unter Windows PowerShell:

$env:DISCORD_TOKEN="your_discord_bot_token"
node build/app.js --transport http --port 3000

Ausführen mit Docker

docker run -e DISCORD_TOKEN=your_discord_bot_token -p 3000:3000 barryy625/mcp-discord:latest --transport http --port 3000

Nach dem Start lautet der MCP-HTTP-Endpunkt:

http://localhost:3000/mcp

3. Verbindung zu einem gehosteten HTTP-MCP-Server

Wenn Sie mcp-discord bereits an anderer Stelle hosten, verweisen Sie Ihren MCP-Client auf den /mcp-Endpunkt des Servers, anstatt build/app.js als Befehl zu starten.

Beispiel-Endpunkt:

https://your-server.example.com/mcp

Wichtige Hinweise:

• build/app.js startet einen HTTP-Server. Er spricht kein stdio.

• build/index.js ist der korrekte Einstiegspunkt für befehlsbasierte Stdio-MCP-Clients.

• Konfigurieren Sie für die gehostete HTTP-Nutzung Ihren MCP-Client so, dass er eine Verbindung zur HTTP-Endpunkt-URL herstellt, die von Ihrer Bereitstellung bereitgestellt wird.

• Das genaue Format der HTTP-Client-Konfiguration hängt vom verwendeten MCP-Client ab.

Tool-Dokumentation

Grundlegende Funktionen

• discord_login: Anmeldung bei Discord mit dem konfigurierten Token

• discord_list_servers: Auflisten aller Discord-Server, auf denen der Bot Mitglied ist

• discord_send: Senden einer Nachricht an einen bestimmten Kanal

• discord_get_server_info: Abrufen von Discord-Serverinformationen

Kanalverwaltung

• discord_create_text_channel: Erstellen eines Textkanals

• discord_create_forum_channel: Erstellen eines Forenkanals

• discord_create_voice_channel: Erstellen eines Sprachkanals

• discord_edit_channel: Bearbeiten eines Kanalnamens, Themas, übergeordneten Kategorien oder der Position

• discord_delete_channel: Löschen eines Kanals

• discord_create_category: Erstellen einer Kanalkategorie

• discord_edit_category: Bearbeiten einer Kanalkategorie

• discord_delete_category: Löschen einer Kanalkategorie

• discord_set_channel_permissions: Festlegen von Berechtigungs-Overrides für eine Rolle oder einen Benutzer in einem Kanal/einer Kategorie

• discord_remove_channel_permissions: Entfernen von Berechtigungs-Overrides aus einem Kanal/einer Kategorie

Forenfunktionen

• discord_get_forum_channels: Abrufen einer Liste von Forenkanälen

• discord_create_forum_post: Erstellen eines Forenbeitrags

• discord_get_forum_post: Abrufen eines Forenbeitrags

• discord_list_forum_threads: Auflisten aktiver und archivierter Threads in einem Forenkanal

• discord_reply_to_forum: Antworten auf einen Forenbeitrag

• discord_get_forum_tags: Abrufen aller verfügbaren Tags für einen Forenkanal

• discord_set_forum_tags: Ersetzen der verfügbaren Tags für einen Forenkanal

• discord_update_forum_post: Aktualisieren des Titels, der Tags, des Archivierungsstatus oder des Sperrstatus eines Forenbeitrags

• discord_delete_forum_post: Löschen eines Forenbeitrags

Nachrichten und Reaktionen

• discord_search_messages: Suchen von Nachrichten auf einem Server

• discord_read_messages: Lesen von Kanalnachrichten (unterstützt before, after, around Parameter — akzeptiert Snowflake-IDs oder ISO 8601-Daten wie "2025-03-01T00:00:00Z")

• discord_edit_message: Bearbeiten einer vom Bot verfassten Nachricht

• discord_add_reaction: Hinzufügen einer Reaktion zu einer Nachricht

• discord_add_multiple_reactions: Hinzufügen mehrerer Reaktionen zu einer Nachricht

• discord_remove_reaction: Entfernen einer Reaktion von einer Nachricht

• discord_delete_message: Löschen einer bestimmten 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 über einen Webhook an einen Discord-Kanal

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

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

Rollenverwaltung

• discord_list_roles: Auflisten aller Rollen auf einem Server

• discord_create_role: Erstellen einer Rolle mit Farb-, Hoist-, Erwähnbarkeits- und Berechtigungsoptionen

• discord_edit_role: Bearbeiten einer bestehenden Rolle

• discord_delete_role: Löschen einer Rolle

• discord_assign_role: Zuweisen einer Rolle an ein Mitglied

• discord_remove_role: Entfernen einer Rolle von einem Mitglied

Mitgliederverwaltung

• discord_list_members: Auflisten von Mitgliedern auf einem Server mit Rollen

• discord_get_member: Abrufen detaillierter Informationen über ein bestimmtes Mitglied

Entwicklung

# Development mode
npm run dev

Lizenz

MIT-Lizenz