yt-slack-mcp

Servidor MCP para Slack — lee enlaces permanentes, hilos e historial de canales; responde en hilos; añade reacciones.

Implementa la especificación del Model Context Protocol: se ejecuta sobre el transporte stdio, habla JSON-RPC 2.0, negocia la versión del protocolo en initialize, anuncia las capacidades de tools y describe cada herramienta con un JSON Schema. La negociación de la versión del protocolo la gestiona la clase Server de @modelcontextprotocol/sdk, que por defecto usa la última versión compatible.

Herramientas

Las herramientas de lectura usan la API privada de la sesión del navegador de Slack (mediante tokens xoxc / xoxd), por lo que pueden acceder a contenido privado de archivos: los PDF se descargan y se les extrae el texto (hasta 50 páginas / 100 000 caracteres), y las imágenes se devuelven en línea.

Related MCP server: Slack MCP Server

Configuración

1. Obtener tokens de sesión del navegador

• xoxc: token de localStorage de Slack web (de tu sesión de navegador iniciada).

• xoxd: cookie de Slack llamada d.

Puede que sea necesario renovarlos cuando Slack rote o invalide la sesión.

2. Colocar los secretos

Guarda cada token en un archivo de una sola línea:

~/.config/opencode/secrets/slack-xoxc.txt
~/.config/opencode/secrets/slack-xoxd.txt

O sobrescribe las rutas mediante el archivo de configuración o variables de entorno.

3. (Opcional) Configurar canales y rutas de escritura permitidos

Toda la configuración puede vivir en un archivo JSON en ~/.config/yt-slack-mcp/config.json (sobrescríbelo con SLACK_MCP_CONFIG):

{
  "secretsDir": "~/.config/opencode/secrets",
  "xoxcPath": "~/.config/opencode/secrets/slack-xoxc.txt",
  "xoxdPath": "~/.config/opencode/secrets/slack-xoxd.txt",
  "allowedWriteChannels": ["C0123456789", "C0987654321"],
  "userAgent": "Mozilla/5.0"
}

Por defecto, las herramientas de escritura (slack_reply_to_thread, slack_add_reaction) están bloqueadas: ningún canal es escribible. Todos los campos son opcionales; si falta el archivo, se usan los valores por defecto. Las variables de entorno siempre anulan el archivo de configuración.

Configuración

Orden de resolución de la configuración: valores por defecto integrados → archivo de configuración → variables de entorno.

Configuración del host MCP

opencode

{
  "mcp": {
    "slack": {
      "type": "local",
      "command": ["npx", "yt-slack-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["yt-slack-mcp"]
    }
  }
}

Licencia

MIT