discord-mcp

Lesen und bedienen Sie Discord über Ihren eigenen laufenden Desktop-Client: Kanalnachrichten, Direktnachrichten, Gruppenchats, Threads, Forumsbeiträge und Suche.

So funktioniert es

Discords Desktop-App ist Electron. Mit --remote-debugging-port gestartet, ist ihr Renderer über das Chrome DevTools Protocol erreichbar. discord-mcp hängt sich an diesen Renderer an, beobachtet den Header, den der Client bei seinen eigenen API-Aufrufen bereits mitsendet, und sendet Anfragen von innerhalb derselben Seite aus.

Jede Anfrage stammt daher aus dem echten Client-Prozess, in der echten Sitzung, mit dem echten Fingerabdruck. Es gibt keinen zweiten Client zu erkennen, und das Token wird nie aus Discords Speicher gelesen: Es wird ausschließlich bei einer Anfrage beobachtet, die der Client ohnehin schon stellt.

Related MCP server: discord-user-mcp

Lesen Sie dies, bevor Sie es verwenden

Dies verstößt gegen die Nutzungsbedingungen von Discord. Die Automatisierung eines Benutzerkontos ist unabhängig davon verboten, wie die Sitzung erlangt wurde, und Abschnitt 11 verbietet zusätzlich das Modifizieren des Clients.

Das praktische Risiko liegt in derselben Kategorie wie Client-Mods wie Vencord, die Discord öffentlich als weniger prioritär eingestuft hat und für die es bis 2026 keine bestätigten Sperren gibt. Das ist ein Muster der Nichtdurchsetzung, kein Versprechen. Das Risiko konzentriert sich auf das Schreiben, nicht auf das Lesen.

Ein Bot-Token wäre vollständig konform, aber ein Bot kann niemals Ihre Direktnachrichten lesen. Diese Einschränkung ist der eigentliche Grund, warum dieses Projekt existiert.

Einrichtung

npm install
npm run build

Discord verwendet eine Single-Instance-Sperre, daher wirkt das Debugging-Flag nur beim Start. Beenden Sie zuerst einen eventuell laufenden Client.

node dist/cli/main.js launch      # starts Discord on a random loopback port
node dist/cli/main.js doctor      # verifies attach, capture and a real read

doctor sollte Ihr Konto, die Anzahl der Guilds und die Anzahl der Direktnachrichten ausgeben.

Der erste Attach lädt den Renderer einmal neu, da ein untätiger Client keine REST-Anfragen stellt, von denen Header abzulesen wären. Die Erfassung wird dann pro Port für zwölf Stunden in ~/.local/state/discord-mcp/headers.json gespeichert, sodass spätere Läufe in etwa einer Sekunde andocken und Ihren Client in Ruhe lassen.

Anbindung an einen MCP-Client

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["/path/to/discord-mcp/dist/cli/main.js", "serve"]
    }
  }
}

Werkzeuge

Standardmäßig sind achtzehn Werkzeuge verfügbar: zwölf lesende und sechs schreibende.

Das Lesen eines Forums erfolgt durch Auflisten der Threads eines Forum-Kanals. Jeder Beitrag wird zusammen mit der Nachricht, die ihn eröffnet hat, und seinen angewendeten Tags zurückgegeben, sodass ein Beitrag ohne einen zweiten Aufruf lesbar ist.

Destruktive Werkzeuge

Sieben weitere Operationen existieren und sind überhaupt nicht registriert, es sei denn, ihre Kategorie ist aktiviert. Sie erscheinen nicht in der Werkzeugliste, sodass kein Host und kein Modell sie erreichen kann.

Aktivieren Sie nur, was Sie benötigen:

{ "destructive": ["messages", "threads"] }

node dist/cli/main.js serve --config /path/to/policy.json

Dies ist die tragende Kontrolle. Host-Genehmigungsabfragen sind eine zweite Ebene, da sich das Verhalten der Hosts unterscheidet und einige Hosts automatisch genehmigen. Jedes destruktive Werkzeug ermittelt das Ziel und gibt zurück, worauf es eingewirkt hat; das Ergebnis benennt den Kanal, statt nur eine Snowflake zu wiederholen.

Sicherheit

Ein offener DevTools-Port ist eine lokale Authentifizierungsumgehung: Jeder Prozess, der unter Ihrer Benutzerkennung läuft, kann die Sitzung steuern, selbst wenn eine Zwei-Faktor-Authentifizierung aktiv ist. discord-mcp bindet nur an Loopback und wählt einen zufälligen hohen Port statt des Standardports 9222. Lassen Sie den Client nicht mit geöffnetem Port laufen, wenn Sie ihn nicht verwenden.

Der Header-Cache enthält ein aktives Token. Eine Erfassung wiederzuverwenden bedeutet, sie zu behalten; daher enthält ~/.local/state/discord-mcp/headers.json Ihren Authorization-Header, bis er abläuft. Die Datei wird nur für den Besitzer geschrieben, Modus 0600, ebenso wie der danebenliegende Startzustand. Löschen Sie die Datei, um eine neue Erfassung zu erzwingen:

rm ~/.local/state/discord-mcp/headers.json

Starten Sie das Programm ohne Cache-Pfad, wenn Sie lieber jedes Mal neu erfassen und das Token nie speichern möchten, auf Kosten eines Renderer-Neuladens bei jedem Attach.

Aufbau

src/attach/     CDP connection, target selection, launch, state
src/bridge/     header capture, request execution, rate limiting
src/api/        typed wrappers over Discord REST v9
src/normalize/  reduce Discord's wire format to what a reader needs
src/policy/     operation tiers and the destructive gate
src/tools/      MCP tool registration
src/cli/        launch, doctor, serve

Abhängigkeiten verlaufen nur nach unten. normalize/ und policy/ sind rein und haben keinerlei Abhängigkeiten; dort befindet sich der Großteil der Testsuite.

npm test         # 152 tests, no Discord required
npm run typecheck

Das Designdokument, einschließlich der Erkenntnisse aus Spike 0, die die Brücke geprägt haben, befindet sich in docs/superpowers/specs/.