servidor slack-mcp

Un servidor MCP (Protocolo de Contexto de Modelo) para acceder a la API de Slack. Este servidor permite a los asistentes de IA interactuar con la API de Slack mediante una interfaz estandarizada.

Características

Herramientas disponibles:

slack_list_channels : enumera los canales públicos en el espacio de trabajo con paginación
slack_post_message : publica un nuevo mensaje en un canal de Slack
slack_reply_to_thread - Responder a un hilo de mensajes específico en Slack
slack_add_reaction - Agrega un emoji de reacción a un mensaje
slack_get_channel_history - Obtener mensajes recientes de un canal
slack_get_thread_replies : obtener todas las respuestas en un hilo de mensajes
slack_get_users : recupera información básica del perfil de todos los usuarios en el espacio de trabajo
slack_get_user_profile - Obtener la información del perfil de un usuario
slack_search_messages - Buscar mensajes en el espacio de trabajo

Inicio rápido

Instalación

npm install @ubie-oss/slack-mcp-server

NOTA: Ahora está alojado en el Registro de GitHub, por lo que necesita su PAT.

Configuración

Debes configurar las siguientes variables de entorno:

SLACK_BOT_TOKEN : Token OAuth de usuario de bot de Slack
SLACK_USER_TOKEN : Token OAuth de usuario de Slack (necesario para algunas funciones como la búsqueda de mensajes)

También puede crear un archivo .env para configurar estas variables de entorno:

SLACK_BOT_TOKEN=xoxb-your-bot-token
SLACK_USER_TOKEN=xoxp-your-user-token

Uso

Iniciar el servidor MCP

Directamente:

npx @ubie-oss/slack-mcp-server

O bien, ejecute el módulo instalado con el nodo:

node node_modules/.bin/slack-mcp-server

Edite el json de configuración de MCP para su cliente:

{
  "slack": {
    "command": "npx",
    "args": [
      "-y",
      "@ubie-oss/slack-mcp-server"
    ],
    "env": {
      "NPM_CONFIG_//npm.pkg.github.com/:_authToken": "<your-github-pat>",
      "SLACK_BOT_TOKEN": "<your-bot-token>",
      "SLACK_USER_TOKEN": "<your-user-token>"
    }
  }
}

Patrón de implementación

Este servidor adopta el siguiente patrón de implementación:

Definir solicitud/respuesta usando esquemas Zod
- Esquema de solicitud: Definir parámetros de entrada
- Esquema de respuesta: definir respuestas limitadas a los campos necesarios
Flujo de implementación:
- Validar solicitud con el esquema Zod
- Llamar a Slack WebAPI
- Analizar la respuesta con el esquema Zod para limitarla a los campos necesarios
- Devolver como JSON

Por ejemplo, la implementación slack_list_channels analiza la solicitud con ListChannelsRequestSchema , llama a slackClient.conversations.list y devuelve la respuesta analizada con ListChannelsResponseSchema .

Desarrollo

Scripts disponibles

npm run dev - Inicia el servidor en modo de desarrollo con recarga en caliente
npm run build : compila el proyecto para producción
npm run start : inicia el servidor de producción
npm run lint : ejecuta comprobaciones de linting (ESLint y Prettier)
npm run fix : corrige automáticamente los problemas de pelusa

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones
Ejecutar pruebas y linting: npm run lint
Confirme sus cambios
Empujar hacia la rama
Crear una solicitud de extracción

Slack MCP Server

Integrations