discord-mcp

Produktionsreifer Model Context Protocol-Server, der die vollständige Discord REST API für KI-Agenten bereitstellt.

Status: v0.9.0 · 192 Tools · OTel-instrumentiert · Cockatiel-resilient · Audit-protokolliert

Siehe Design-Spezifikation für die Architektur.

Schnellstart

# 1. Install
npm install -g @discord-mcp/cli  # or use npx

# 2. Bootstrap config for your MCP client
discord-mcp init --client claude-desktop --token "Bot YOUR.BOT.TOKEN"

# 3. Verify configuration
discord-mcp doctor --online

# 4. Run (or let your MCP client launch it)
discord-mcp serve

Unterbefehle

discord-mcp serve (Standard)

Startet den stdio MCP-Server. Dies ist die Standardaktion, wenn kein Unterbefehl angegeben wird.

Flags:

• --gateway — Aktiviert Discord Gateway-Ressourcenabonnements (lädt discord.js verzögert)

discord-mcp doctor

Diagnostiziert Konfiguration und Konnektivität. Beendet mit 0 (gesund), 1 (Warnungen) oder 2 (Fehler).

Flags:

• --online — Führt Netzwerkprüfungen durch (Discord-Token-Verifizierung, OTel-Erreichbarkeit)

• --json — Ausgabe als JSON für CI-Verarbeitung

Offline-Prüfungen: node-version, token-format, env-vars, audit-sink, client-caps Online-Prüfungen (mit --online): token-online, otel-reachable

discord-mcp init

Initialisiert die Konfiguration + generiert ein MCP-Client-Konfigurations-Snippet.

Flags:

• --token <token> — Discord-Bot-Token (oder ${env:DISCORD_TOKEN} Platzhalter)

• --client <id> — Client: claude-desktop, claude-code, cursor oder generic

• --output <path> — Schreibt das Snippet in eine Datei (Standard: stdout)

• --force — Überschreibt eine bestehende Ausgabedatei

• --gateway — Aktiviert Discord Gateway in der generierten Konfiguration

• --json — JSON-Ausgabe für CI

Wenn stdin ein TTY ist und Flags fehlen, führt init einen interaktiven Assistenten aus.

discord-mcp migrate

Migration von einem anderen Discord/MCP-Setup. Beendet mit 0 (alle zugeordnet), 1 (einige nicht zugeordnet), 2 (Fehler).

Flags:

• --from <adapter> — Quell-Adapter-ID (ohne --from ausführen, um alle aufzulisten)

• --source <path> — Pfad zum Quell-Repository (Standard: cwd)

• --json — JSON-Ausgabe

Verfügbare Adapter: hubdustry-go-mcp (Referenzimplementierung). Weitere in Plan 11.

Tool-Oberfläche

192 Tools in folgenden Bereichen:

• messages (12)

• channels (14)

• threads (6)

• members (14)

• roles (5)

• guild (16)

• audit_log (1)

• webhooks (13)

• events (6)

• commands (15)

• users (6)

• components-v2 (8)

• intelligence (5)

• meta (1)

• reactions (5)

• emojis (5)

• app_emojis (5)

• stickers (7)

• invites (4)

• automod (5)

• interactions (8)

• application (5)

• stage_instances (4)

• soundboard (7)

• polls (2)

• voice (3)

• onboarding (2)

• monetization (8)

Lokale Entwicklung

Voraussetzungen: Node ≥20.11, pnpm ≥9.15.

pnpm install
pnpm build
pnpm test

Rauchtest (echtes Discord)

Setzen Sie DISCORD_TOKEN auf ein echtes Bot-Token von https://discord.com/developers/applications:

export DISCORD_TOKEN="Bot YOUR_TOKEN_HERE"
node packages/mcp-server/dist/cli.js

Verwenden Sie dann den MCP Inspector in einem anderen Terminal:

npx -y @modelcontextprotocol/inspector node packages/mcp-server/dist/cli.js

Öffnen Sie die Inspector-Benutzeroberfläche unter http://localhost:5173, klicken Sie auf tools/list, und Sie sollten alle 192 Tools sehen.

Dokumentation

• Betrieb: Telemetrie — OTel-Einrichtung

• Betrieb: Resilienz — Anpassung von Retry/Timeout/Circuit

• Betrieb: Audit — Audit-Sinks + Compliance

Lizenz

MIT — siehe LICENSE.