discord-mcp

Lee y actúa en Discord a través de tu propio cliente de escritorio en ejecución: mensajes de canal, mensajes directos, chats de grupo, hilos, publicaciones de foro y búsqueda.

Cómo funciona

La aplicación de escritorio de Discord es Electron. Iniciada con --remote-debugging-port, su renderizador es accesible a través del Protocolo Chrome DevTools. discord-mcp se conecta a ese renderizador, observa el conjunto de cabeceras que el cliente ya envía en sus propias llamadas a la API, y realiza peticiones desde dentro de la misma página.

Por lo tanto, cada petición proviene del proceso real del cliente, en la sesión real, con la huella digital real. No hay un segundo cliente que detectar, y el token nunca se lee del almacenamiento de Discord: solo se observa en una petición que el cliente ya estaba haciendo.

Related MCP server: discord-user-mcp

Léelo antes de usarlo

Esto viola los Términos del Servicio de Discord. Automatizar una cuenta de usuario está prohibido independientemente de cómo se haya obtenido la sesión, y la sección 11 prohíbe por separado modificar el cliente.

El riesgo práctico se sitúa en la misma categoría que los mods del cliente como Vencord, a los que Discord ha restado prioridad públicamente y que no tienen baneos confirmados a fecha de 2026. Ese es un patrón de no aplicación, no una promesa. El riesgo se concentra en escribir, no en leer.

Un token de bot sería totalmente conforme, pero un bot nunca puede leer tus mensajes directos. Esa limitación es la razón de ser de este proyecto.

Configuración

npm install
npm run build

Discord mantiene un bloqueo de instancia única, así que la marca de depuración solo tiene efecto al inicio. Cierra cualquier cliente en ejecución primero.

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 debería mostrar tu cuenta, el número de servidores y el número de mensajes directos.

La primera conexión recarga el renderizador una vez, porque un cliente inactivo no hace ninguna petición REST de la que observar cabeceras. La captura se recuerda después por puerto durante doce horas en ~/.local/state/discord-mcp/headers.json, así que las ejecuciones posteriores se conectan en aproximadamente un segundo y no tocan tu cliente.

Conectándolo a un cliente MCP

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

Herramientas

Dieciocho herramientas están expuestas por defecto: doce de lectura y seis de escritura.

Leer un foro funciona listando los hilos del canal del foro. Cada publicación devuelve el mensaje que la abrió y sus etiquetas aplicadas, así que una publicación se puede leer sin una segunda llamada.

Herramientas destructivas

Existen siete operaciones más y no se registran en absoluto a menos que su categoría esté habilitada. No aparecen en la lista de herramientas, así que ningún host ni ningún modelo puede acceder a ellas.

Habilita solo lo que necesites:

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

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

Este es el control clave. Las solicitudes de aprobación del host son una segunda capa, porque el comportamiento del host varía y algunos hosts aprueban automáticamente. Cada herramienta destructiva resuelve y devuelve aquello sobre lo que actuó, de modo que el resultado nombra el canal en lugar de limitarse a repetir un snowflake.

Seguridad

Un puerto de DevTools abierto es una omisión de la autenticación local: cualquier proceso que se ejecute como tú puede manejar la sesión, incluida la verificación en dos pasos. discord-mcp se vincula solo a loopback y elige un puerto alto aleatorio en lugar del 9222 por defecto. No dejes el cliente en ejecución con el puerto abierto cuando no lo estés usando.

La caché de cabeceras contiene un token activo. Reutilizar una captura implica conservarlo, así que ~/.local/state/discord-mcp/headers.json contiene tu cabecera Authorization hasta que expire. Se escribe solo para el propietario, con modo 0600, y lo mismo ocurre con el estado de inicio que está a su lado. Elimina el archivo para forzar una captura nueva:

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

Ejecuta sin una ruta de caché si prefieres capturar cada vez y no almacenar nunca el token, a costa de recargar el renderizador en cada conexión.

Estructura

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

Las dependencias solo fluyen hacia abajo. normalize/ y policy/ son puros y no dependen de nada, y es donde vive la mayor parte del conjunto de pruebas.

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

El documento de diseño, incluidos los hallazgos del Spike 0 que dieron forma al puente, está en docs/superpowers/specs/.