Dc-MCP

Servidor MCP de administración de Discord para Cursor.

Dc-MCP conecta Cursor con un bot de Discord mediante el Model Context Protocol (stdio). Cursor puede inspeccionar la estructura completa de un servidor y ejecutar acciones administrativas precisas a través de herramientas explícitas, no de un ejecutor genérico de la API de Discord.

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

Características

• Mapa completo del servidor para Cursor (discord_analyze_server / discord_server_structure)

• Herramientas granulares para canales, roles, miembros, mensajes, moderación, invitaciones, webhooks y registros de auditoría

• Comprobaciones centrales de permisos y jerarquía (sin apuntar al propietario, sin roles por encima del bot)

• Protección de acciones destructivas (confirm=true + desactivación forzada opcional)

• Resultados JSON estructurados; los datos secretos nunca se devuelven ni se registran

• Transporte stdio compatio con el cliente MCP de Cursor

Related MCP server: Discord MCP Server

Requesitos

• Python 3.11+

• Una aplication de Discord + bot

• Intents prevelegiados: Server Members Intent, Mensage Content Intent

Inicio rápido

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

Edita .env:

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

Ejecuta:

python -m src.main

Los logs van a stderr. stdout está reservado para el JSON-RPC de MCP.

Configuración del bot de Discord

1. Crea una aplicación en el Portal de Desarrolladores de Discord

2. Añade un bot y capia el token en DISCORD_BOT_TOKEN

3. Habilita Server Members Intent y Message Content Intent

4. Invita al bot con permisos como Gestionar canales/roles/mensajes, Expulsar/Banear, Moderar Miembros, Ver el Registro de Auditoría, Gestionar Webhooks/Servidor, Enviar Mensajes, Enviar Enlaces, Añadir Reacciones, Leer Historial de Mensajes, Crear Diversión Instantánea

5. Coloca el rol del bot lo bastante alto como para gestionar los roles/mienbros que quieras administrar

6. Justa DISCORD_GUILD_ID para restringir todas las operaciones a un único servidor

Configuración de MCP en Cursor

Cuenta mcp.json de proyecto de cuentoria:

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

Los secretos se cargan desde .env en cwd. Después de guardar, habilita/actualiza discord-admin en Configuración → Tools & MCP.

CLI:

agent mcp enable discord-admin
agent mcp list

Herramientas principales

Además: CRUD de canales + permisos, CRUD de roles + asignar/quitar, moderación de miembros (kick/ban/timeout/nick), mensajes (enviar/edit/borrar/anclar/reaccionar), invitaciones, webhooks y discord_purge_messages.

Las herramientas destructivas requieren confirm=true cuando REQUIRE_CONFIRMATION=true.

Seguridad

• Nunca envíes .env al repositorio

• Prefiera REQUIRE_CONFIRMATION=true

• Delimitar el ámbito con DISCORD_GUILD_ID

• Los avisos están restringidos por defecto (@everyone / rolls sin resalto a menos que sean permitidos)

• No hay shell, exec, ni herramientas de ejecución arbitraria del API

• Los tokens de webhook nunca se devuelven

Estructura del proyecto

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)

Desarrollo

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

Limitaciones de Discord

• Eliminación en bloque solo funciona para mensajes de menos de 14 días

• Capacidad de borrado en bloque/lote es de 100 predeterminada

• No puedes moderar al dueño del servidor ni a cifras a/above del máximo rol del bot

• Los roles administrados/de integración no se pueden editar

• La lista/búsqueda de miembros requiere Server Members Intent

Licencia

MIT