Dc-MCP

Discord Administration MCP Server für Cursor.

Dc-MCP verbindet Cursor über das Model Context Protocol (stdio) mit einem Discord-Bot. Cursor kann die vollständige Struktur eines Servers einsehen und präzise Admin-Aktionen über explizite Tools ausführen – nicht über einen freien Discord-API-Executor.

Cursor  ──MCP (stdio)──▶  Dc-MCP  ──discord.py──▶  Discord API

Funktionen

• Vollständige Serverübersicht für Cursor (discord_analyze_server / discord_server_structure)

• Granulare Tools für Kanäle, Rollen, Mitglieder, Nachrichten, Moderation, Einladungen, Webhooks und Audit-Logs

• Zentrale Berechtigungs- und Hierarchieprüfungen (kein Targeting des Besitzers, keine Rollen über dem Bot)

• Schutz vor destruktiven Aktionen (confirm=true + optionales hartes Deaktivieren)

• Strukturierte JSON-Ergebnisse; Geheimnisse werden nie zurückgegeben oder protokolliert

• Stdio-Transport kompatibel mit Cursors MCP-Client

Related MCP server: Discord MCP Server

Anforderungen

• Python 3.11+

• Eine Discord-Anwendung + Bot

• Privilegierte Intents: Server Members Intent, Message Content Intent

Schnellstart

git clone https://github.com/669px/Dc-MCP.git
cd Dc-MCP
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -e .
cp .env.example .env

Bearbeiten Sie .env:

DISCORD_BOT_TOKEN=your_bot_token
DISCORD_GUILD_ID=your_guild_id
ALLOW_DANGEROUS_ACTIONS=true
REQUIRE_CONFIRMATION=true
LOG_LEVEL=INFO

Ausführen:

python -m src.main

Logs gehen an stderr. stdout ist für MCP JSON-RPC reserviert.

Discord-Bot-Einrichtung

1. Erstellen Sie eine Anwendung im Discord Developer Portal

2. Fügen Sie einen Bot hinzu und kopieren Sie das Token in DISCORD_BOT_TOKEN

3. Aktivieren Sie Server Members Intent und Message Content Intent

4. Laden Sie den Bot mit Berechtigungen wie Kanäle/Rollen/Nachrichten verwalten, Kicken/Bannen, Mitglieder moderieren, Audit-Log ansehen, Webhooks/Server verwalten, Nachrichten senden, Einbettungen, Reaktionen hinzufügen, Nachrichtenverlauf lesen, Sofortige Einladung erstellen

5. Platzieren Sie die Bot-Rolle hoch genug, um die Rollen/Mitglieder zu verwalten, die Sie verwalten möchten

6. Setzen Sie DISCORD_GUILD_ID, um alle Operationen auf einen Server zu beschränken

Cursor-MCP-Konfiguration

Projekt- oder Benutzer-mcp.json:

{
  "mcpServers": {
    "discord-admin": {
      "command": "/ABSOLUTE/PATH/TO/Dc-MCP/.venv/bin/python",
      "args": ["-m", "src.main"],
      "cwd": "/ABSOLUTE/PATH/TO/Dc-MCP"
    }
  }
}

Geheimnisse werden aus .env im cwd geladen. Nach dem Speichern aktivieren/aktualisieren Sie discord-admin unter Einstellungen → Tools & MCP.

CLI:

agent mcp enable discord-admin
agent mcp list

Kern-Tools

Ebenfalls enthalten: Kanal-CRUD + Berechtigungen, Rollen-CRUD + Zuweisen/Entfernen, Mitgliedermoderation (Kicken/Bannen/Timeout/Nickname), Nachrichten (Senden/Bearbeiten/Löschen/Anpinnen/Reagieren), Einladungen, Webhooks und discord_purge_messages.

Destruktive Tools erfordern confirm=true, wenn REQUIRE_CONFIRMATION=true ist.

Sicherheit

• Committen Sie niemals .env

• Bevorzugen Sie REQUIRE_CONFIRMATION=true

• Begrenzen Sie mit DISCORD_GUILD_ID

• Erwähnungen sind standardmäßig eingeschränkt (@everyone / Massenrollen aus, sofern nicht erlaubt)

• Keine Shell-, eval-, HTTP-Proxy- oder generischen API-Executor-Tools

• Webhook-Tokens werden nie zurückgegeben

Projektstruktur

src/
  main.py              MCP entrypoint (stdio)
  config.py            Environment settings
  discord_client.py    discord.py client
  permissions.py       Guild / hierarchy / confirmation gates
  errors.py            Structured error mapping
  responses.py         Success / failure payloads
  server_map.py        Full guild analysis for Cursor
  tools/               Granular MCP tools
tests/                 Unit tests (mocked Discord)

Entwicklung

source .venv/bin/activate
python -m compileall src
python -m pytest
python -c "import discord; print(discord.__version__)"

Discord-Einschränkungen

• Massenlöschung funktioniert nur für Nachrichten, die jünger als 14 Tage sind

• Massen-/Purge-Obergrenzen standardmäßig 100

• Kann den Serverbesitzer oder Ziele auf/über der höchsten Rolle des Bots nicht moderieren

• Verwaltete/Integrationsrollen können nicht bearbeitet werden

• Mitgliederliste/-suche erfordert Server Members Intent

Lizenz

MIT