Discord Community MCP

Ein lokaler Model Context Protocol-Server, der KI-Agenten über ein Bot-Konto schreibgeschützten Zugriff auf die Discord-Suche, das Wiederfinden von Unterhaltungen, Community-Recherche und Wachstumsanalysen bietet. Das Senden von Nachrichten und Reaktionen ist nur möglich, wenn es ausdrücklich aktiviert wurde.

Was er kann

• Findet Unterhaltungen aus einer vagen Erinnerung wieder, selbst wenn die Formulierung unklar ist

• Rekonstruiert den Kontext rund um eine passende Nachricht

• Indexiert ausgewählten Discord-Verlauf in einer lokalen SQLite-Datenbank

• Analysiert Aktivität, Reaktionszeiten, Beteiligung, Konzentration, Reziprozität und Themen

• Speichert Mitglieder-Snapshots und analysiert Beitritte, Austritte, Rollen und das Wachstum von Mitwirkenden

• Kann auf Wunsch Nachrichten, Antworten und Reaktionen senden

Related MCP server: Discord MCP Server

Voraussetzungen

• Node.js 22.5 oder neuer

• Eine Discord-Anwendung und ein Bot-Token

• Einen MCP-Client, der lokale stdio-Server unterstützt, z. B. Codex

1. Discord-Bot erstellen

1. Öffnen Sie das Discord Developer Portal und erstellen Sie eine Anwendung.

2. Öffnen Sie Bot, erstellen Sie den Bot und kopieren Sie seinen Token.

3. Aktivieren Sie unter Bot → Privileged Gateway Intents:

   • Message Content Intent für Nachrichteninhalt und Suche

   • Server Members Intent für Mitglieder-Snapshots, Beitrittsdaten, Rollen und Wachstum

4. Presence Intent ist nicht erforderlich.

5. Wählen Sie unter OAuth2 → URL Generator den Bereich bot aus.

6. Erteilen dem Bot View Channels und Read Message History. Fügen Sie Send Messages oder Add Reactions nur hinzu, wenn Sie die Schreibwerkzeuge aktivieren möchten.

7. Öffnen Sie die generierte URL und den bot in Ihren Discord-Server.

Der Bot kann nur auf Kanäle zugreifen, die seine Discord-Rolle anzuzeigen darf.

2. Installation

git clone https://github.com/blackgirlbytes/discord-community-mcp.git
cd discord-community-mcp
npm ci
npm run build
cp .env.example .env

Öffnen Sie .env und ersetzen Sie den Token-Platzhalter:

DISCORD_BOT_TOKEN=replace-with-your-bot-token
DISCORD_ENABLE_WRITE=false

Behandeln Sie .env als privat. Es ist von git ausgeschlossen.

3. Zu einem MCP-Client hinzufügen

Codex CLI

Verwenden Sie absolute Pfade, damit der Client den Server von jedem Verzeichnis aus starten kann:

codex mcp add discord-community -- \
  node \
  --env-file=/absolute/path/to/discord-community-mcp/.env \
  /absolute/path/to/discord-community-mcp/dist/index.js

Starten Sie Codex nach dem Hinzufügen des Servers neu.

Allgemeine stdio-Manager

Clients, die ein mcpServers-JSON-Objekt verwenden, können Folgendes nutzen:

{
  "mcpServers": {
    "discord-community": {
      "command": "node",
      "args": [
        "--env-file=/absolute/path/to/discord-community-mcp/.env",
        "/absolute/path/to/discord-community-mcp/dist/index.js"
      ]
    }
  }
}

Starten Sie den MCP-Client nach der Änderung seiner Konfiguration neu. Sie können ihn dann bitten, die Discord-Server und Kanäle aufzulisten, die dem Bot zur Verfügung stehen.

Beispielfragen

• „Finde die Unterhaltung, in der jemand gesagt hat, dass sich das Onboarding wie Hausaufgaben angefühlt habe.“

• „Was haben wir letztes Frühjahr über die Umbenennung des SDK beschlossen?“

• „Warum antworten Beta-Tester so langsam? Suche nach Belegen in den letzten drei Monaten.“

• „Wie ist die Community Monat für Monat gewachsen, und wie verhält sich das Wachstum zur Beteiligung?“

• „Welche Support-Fragen blieben letzte Woche unbeantwortet?“

Für umfassende Analysen sollte der Agent zuerst die relevanten Kanäle und den Datumsbereich synchronisieren, die Indexabdeckung prüfen und dann Community-Recherche durchführen. Verhaltensbezogene Erklärungen sollten als Hypothesen dargestellt werden, es sei denn, Nachrichten stützen sie direkt.

Verfügbare Tools

Daten und Datenschutz

Nachrichteninhalte und Mitglieder-Metadata werden standardmäßig unverschlüsselt in data/discord-analytics.sqlite gespeichert. Über DISCORD_ANALYTICS_DB kann der Speicherort angepasst werden.

DISCORD_ANALYTICS_DB=/absolute/private/path/discord-analytics.sqlite

• Indexieren Sie nur die Channels und Datenzeiträume, die für die Analyse benötigt werden.

• Schützen und löschen Sie die Datenbank nach den Datenschutzbestimmungen Ihrer Community.

• Erteilen Sie dem Bot die minimal erforderlichen Discord-Berechtigungen.

• Lassen Sie DISCORD_ENABLE_WRITE=false, solange das Senden nicht beabsichtigt ist.

• Ersetzen Sie das Bot-Token sofort, falls es aufgedeckt wurde.

Einschränkungen der Analyse

• Ein Nachrichtenarchiv kann Verhaltensmuster zeigen, aber nicht beweisen, warum sich Menschen so verhalten haben.

• Discord-Nutzer können auf Beiträge antworten, ohne die Antworten-Funktion zu verwenden, daher können Antwortmetriken die tatsächliche Anzahl der Antworten ungenau abbilden.

• Historische Rollen-Zugehörigkeit wird nicht rekonstruiert; ältere Nachrichten verwenden die zuletzt beobachtete Rolle.

• Exakte Austritte werden nur zwischen gespeicherten Mitglieder-Snapshots erkannt.

• Ein erster Mitglieder-Snapshot kann keine Personen wiederherstellen, die vorher gegangen sind, bevor der Bot sie erfasst hat.

• Suche und Analyse decken nur die Channels ab, die für den Bot sichtbar sind und deren Verlauf synchronisiert wurde.

• Direktnachrichten werden nicht unterstützt.

Schreibzugriff

Die Schreibwerkzeuge sind registriert, default jedoch blockiert. Um sie zu aktivieren, aktualisieren Sie .env:

DISCORD_ENABLE_WRITE=true

Der Bot muss auch über die entsprechenden Discord-Berechtigungen verfügen. Bei installations, die nur mit Forschung, in denen nur für die zufrieden sind, wenden Sie die Schreibrechte deaktiviert.

Entwicklung

npm ci
npm run check
npm test

Der Server schreibt Protokolle auf stderr, da stdout für das MCP-stdio-Protokoll reserviert ist.