vencord-mcp

Un servidor MCP que permite a un agente de codificación leer un cliente de Discord en ejecución de la misma manera que lo haría un autor de plugins: stores, módulos webpack, parches, props de React y el propio tráfico de gateway.

Se comunica con cualquier Chromium iniciado con --remote-debugging-port, por lo que funciona en Discord con Vencord o Equicord inyectados, y la mayor parte funciona en cualquier aplicación Electron con un bundle webpack minificado.

Por qué existe esto

Dos mitades de esto ya existían por separado, y ninguna era útil por sí sola.

Existen varios servidores MCP genéricos para Electron y Chrome DevTools. Toman capturas de pantalla, leen la consola y evalúan JavaScript, pero no saben nada sobre webpack, Flux stores o parches de Vencord, por lo que un agente que los utiliza gasta su presupuesto redescubriendo el mismo boilerplate en cada sesión.

Por otro lado, Vencord Companion sabe exactamente lo correcto: si una búsqueda webpack es única, si la coincidencia de un parche compila. Pero es una extensión de VSCode, diseñada para que un humano la lea en un editor.

Nada conectaba ambas cosas. Esto lo hace.

Related MCP server: instagit

Lo que cambia

El bucle normal para escribir un plugin es: abrir devtools, buscar en un bundle minificado, escribir una regex y esperar, compilar, reiniciar Discord, descubrir. Cada error cuesta un reinicio.

Con estas herramientas, el bucle se cierra en segundos y, lo que es más importante, el agente deja de adivinar. test_patch responde si este parche realmente se ejecutaría antes de construir nada. capture_websocket muestra lo que el servidor realmente envió en lugar de lo que la interfaz implicaba. react_props recupera el nombre de un fallo cuya interfaz de usuario solo muestra un número.

Instalar

npm install

Regístralo con tu cliente MCP. La mayoría acepta un bloque de configuración como este:

{
  "mcpServers": {
    "vencord": {
      "command": "node",
      "args": ["/absolute/path/to/vencord-mcp/src/index.js"]
    }
  }
}

Los clientes que incluyen una CLI suelen tener un comando único para lo mismo, del estilo de mcp add vencord -- node /absolute/path/to/vencord-mcp/src/index.js.

Luego inicia Discord con el depurador abierto:

Discord.exe --remote-debugging-port=9223

El puerto solo escucha en localhost, pero es un depurador: cualquier cosa que pueda alcanzarlo puede leer tu sesión. Cierra y vuelve a abrir Discord normalmente cuando hayas terminado.

Herramientas

Solo lectura a menos que se indique lo contrario.

Cada herramienta acepta port (por defecto 9223) y un urlHint opcional para cuando hay más de un destino de página abierto.

Las tres que merecen la instalación

test_patch ejecuta la misma comprobación que Vencord ejecuta al inicio, contra la compilación que realmente se está ejecutando. Una búsqueda que no coincide con ningún módulo significa que el parche nunca se ejecuta silenciosamente, y una búsqueda que coincide con varios significa que Vencord los parchea todos. Ambos son invisibles hasta que el plugin se comporta mal de una manera que parece otra cosa.

test_patch(find: '"2026-08-video-guard"', match: 'variations:\\{.{0,120}?\\}\\}', replace: 'variations:{}')
-> "find is unique and match hits exactly once"

patch_status responde a la pregunta que test_patch no puede: si realmente se ejecutó. Vencord elimina un parche de su lista pendiente una vez que su módulo se carga, por lo que cualquier cosa que aún esté listada nunca coincidió. Ese es el fallo que más tiempo cuesta, porque el plugin se carga, no reporta ningún error y no hace nada silenciosamente. Los parches declarados como all permanecen listados para siempre por diseño y se reportan por separado para que no parezcan rotos.

capture_websocket decodifica los opcodes de voz de Discord por nombre: IDENTIFY, READY, SESSION_DESCRIPTION, VIDEO, MEDIA_SINK_WANTS. Leerlos es la diferencia entre "el video no apareció" y "el servidor ofreció ssrc 267, el cliente lo solicitó a máxima calidad y no llegaron paquetes", que son errores diferentes con soluciones diferentes.

Una advertencia: el dominio Network solo registra los sockets que vio crearse. Una conexión que ya estaba abierta cuando comenzó la captura se reporta como (socket opened before capture) — las tramas aún se decodifican, porque su contenido identifica el protocolo, pero la URL es desconocida. Haz que el cliente se reconecte durante la ventana para obtenerla.

Notas

Discord incluye una CSP estricta que bloquea eval. Cada evaluación aquí establece allowUnsafeEvalBlockedByCSP, que es la forma documentada para que un depurador se ejecute de todos modos; sin ella, cada llamada falla con un EvalError poco útil.

Cada llamada de herramienta abre su propia sesión de depurador y se desconecta. Mantener una abierta entre llamadas solo crearía estado que podría desincronizarse.

Tests

node test/smoke.js

Habla el protocolo real con el servidor real a través de stdio: inicializar, listar las herramientas y luego ejercitar la ruta en vivo contra un Discord en el puerto 9223 si hay uno en ejecución. Un servidor que se inicia no es lo mismo que un servidor que responde.

Licencia

GPL-3.0-or-later, en concordancia con Vencord.