KimpalbokTV Slack

Un servidor de Slack para gestionar canales, mensajes y usuarios del espacio de trabajo, creado por KimpalbokTV.

Documentación

Ejemplo de servidor MCP de Slack de KimpalbokTV

Este repositorio contiene el código de ejemplo del servidor Slack MCP (Model Context Protocol) utilizado por KimpalbokTV. Se integra con el espacio de trabajo de Slack y proporciona diversas funciones relacionadas con canales, mensajes y usuarios.

Funciones principales

  • Consultar la lista de canales públicos o predefinidos del espacio de trabajo
  • Publicar mensajes en canales y responder en hilos
  • Añadir reacciones con emojis a los mensajes
  • Consultar el historial de mensajes del canal y las respuestas en hilos
  • Consultar información de usuarios y perfiles del espacio de trabajo

Instalación y compilación

{
  "mcpServers": {
    "kimpalbok-slack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "kimpalbok-slack-mcp-server"
      ]
    },
    "env": {
      "SLACK_BOT_TOKEN": "xoxb-...",
      "SLACK_TEAM_ID": "T12345678"
    }
  }
}

Configuración de variables de entorno

Antes de ejecutar, debe configurar las siguientes variables de entorno.

  • SLACK_BOT_TOKEN: Token del bot de Slack (ejemplo: xoxb-...)
  • SLACK_TEAM_ID: ID de equipo del espacio de trabajo de Slack (ejemplo: T12345678)
  • (Opcional) SLACK_CHANNEL_IDS: Lista de IDs de canales predefinidos (separados por comas)

Ejemplo:

export SLACK_BOT_TOKEN=xoxb-...
export SLACK_TEAM_ID=T12345678
export SLACK_CHANNEL_IDS=C12345678,C23456789

Configuración del bot de Slack

Enlace de configuración de la aplicación y el bot https://api.slack.com/apps

  • Consulte el "Bot User OAuth Token" en el menú "OAuth & Permissions".

  • Añada permisos en "Scopes" en el menú "OAuth & Permissions".

  • Cómo verificar SLACK_TEAM_ID
    Acceda a https://apps.slack.com y ejecútelo en el navegador.
    La cadena que comienza con "T..." en la URL es el TEAM_ID.

Ejemplos de uso

El servidor proporciona diversas herramientas (tools) a través del protocolo MCP.
A continuación se muestran las principales herramientas compatibles y sus descripciones.

Nombre de la herramientaDescripción
slack_list_channelsConsulta la lista de canales públicos o predefinidos del espacio de trabajo
slack_post_messagePublica un nuevo mensaje en un canal
slack_reply_to_threadResponde en el hilo de un mensaje específico
slack_add_reactionAñade una reacción con emoji a un mensaje
slack_get_channel_historyObtiene los mensajes recientes de un canal
slack_get_thread_repliesObtiene todas las respuestas del hilo de un mensaje
slack_get_usersObtiene todos los usuarios e información básica de perfil del espacio de trabajo
slack_get_user_profileObtiene información detallada del perfil de un usuario específico

Consulte los parámetros de entrada y valores de retorno de cada herramienta en la definición de Tool y los tipos TypeScript del código.

Notas

  • Este servidor se basa en MCP (Model Context Protocol) y funciona con transporte basado en entrada/salida estándar (stdio).
  • Para la integración real con la API de Slack, se necesita un token de bot de Slack con los permisos adecuados.

Contacto: KimpalbokTV