dsh-plugin-discord-operator
Manifest validOperador de Discord para DeepSeek Harness: lista canales y mensajes, envia/edita mensajes y sube archivos con confirmacion, lista blanca de canales y auditoria; nunca lee DMs ni expone el token.
dsh-plugin-discord-operator — operador de Discord para DeepSeek Harness
Plugin MCP local para operar un servidor de Discord sin salir de DSH: listar canales, leer mensajes, enviar y editar mensajes y subir archivos con confirmación explícita, lista blanca de canales y auditoría. Nunca lee DMs y el token no se expone.
English · Cómo funciona · MIT
Herramientas (6)
| Tool | Qué hace |
|---|---|
mcp__discord__status | Estado: token configurado (sin mostrarlo), bot, servidores, modo, listas blancas. |
mcp__discord__channels | Lista canales de texto/anuncios/foros del servidor (nunca DMs). |
mcp__discord__messages | Lee los últimos mensajes de un canal de servidor. |
mcp__discord__send | Envía un mensaje (confirm:true + canal permitido). |
mcp__discord__edit | Edita un mensaje del bot (confirm:true + canal permitido). |
mcp__discord__upload | Sube un archivo local (confirm:true + canal y ruta permitidos). |
Configuración del token
El token se toma, en este orden:
- Variable de entorno del host
DISCORD_BOT_TOKEN(la pasa la fila MCP). - Archivo local
<DSH_HOME>\discord-operator\config.json:
{
"token": "TU_TOKEN_DE_BOT",
"guildId": "123456789012345678",
"allowedChannels": ["anuncios", "123456789012345678"],
"allowedPaths": ["C:\\Users\\tu-usuario\\.dsh\\cache"]
}
allowedChannels: ids o nombres (#canalocanal) donde se permite escribir. Si está vacío, las escrituras se rechazan.allowedPaths: carpetas desde las que se pueden subir archivos.- El
postinstallcrea el archivo vacío para que solo completes el token. - Nunca commitees el token.
Instalación
Desde DSH → Settings → Plugins instala
github:thegabopacheco-sudo/dsh-plugin-discord-operator y permite el script de
instalación.
Por CLI:
dsh plugin --profile <perfil> add github:thegabopacheco-sudo/dsh-plugin-discord-operator
El postinstall copia el runtime a <DSH_HOME>\plugins\discord-operator y crea
<DSH_HOME>\discord-operator\config.json.
Requisitos: Windows 10/11, Node ≥ 20 (lo aporta el harness) y un bot de Discord con permisos de lectura/escritura en los canales configurados.
Seguridad
- Lectura por defecto, escritura solo con
confirm:truey pedido explícito. - Lista blanca de canales para escritura; lista blanca de rutas para subir.
- Nunca DMs: solo se resuelven canales de servidor (texto/anuncios/foros).
- Auditoría en
<DSH_HOME>\cache\discord-operator\audit.jsonl(sin contenido). - Rate limit de 10 escrituras por minuto.
- Read-only:
DSH_DISCORD_MODE=read-onlydesactiva send/edit/upload. - El token no se devuelve en ninguna tool ni se escribe en logs.
Variables de entorno
| Variable | Uso |
|---|---|
DISCORD_BOT_TOKEN | Token del bot (alternativa al config). |
DSH_DISCORD_MODE | read-only. |
DSH_DISCORD_API_BASE | Base de la API (default https://discord.com/api/v10; para tests). |
DSH_DISCORD_SKIP_POSTINSTALL | 1 omite el despliegue. |
Solución de problemas
- “falta el token”: define
DISCORD_BOT_TOKENo completa el config. - 403/401: token inválido o el bot no está en el servidor/ canal.
- “no hay canales permitidos”: completa
allowedChannels. - “ruta no permitida”: agrega la carpeta en
allowedPaths. - Permiso de scripts en la instalación: aprueba el
postinstall; si el cartel se repite,allowBuilds: trueenpnpm-workspace.yamldel perfil.
Desarrollo
npm install
npm run build:bundle
cd test; npm install; node connect-test.mjs # usa un mock local de la API de Discord
Licencia
MIT © thegabopacheco-sudo
Comments
Loading…