Servidor MCP de Mattermost

Servidor MCP para la API de Mattermost, que permite a Claude y otros clientes de MCP interactuar con los espacios de trabajo de Mattermost.

Características

Este servidor MCP proporciona herramientas para interactuar con Mattermost, incluidas:

Monitoreo de temas

El servidor incluye un sistema de monitoreo de temas que puede:

• Monitorear canales específicos para mensajes que contengan temas de interés

• Ejecutar según un cronograma configurable (usando la sintaxis cron)

• Enviar notificaciones cuando se discutan temas relevantes

• Mencionarte en un canal específico cuando se encuentren temas

Herramientas de canal

• mattermost_list_channels : enumera los canales públicos en el espacio de trabajo

• mattermost_get_channel_history : Obtener mensajes recientes de un canal

Herramientas de mensajes

• mattermost_post_message : Publicar un nuevo mensaje en un canal

• mattermost_reply_to_thread : Responder a un hilo de mensajes específico

• mattermost_add_reaction : Agrega una reacción emoji a un mensaje

• mattermost_get_thread_replies : Obtener todas las respuestas en un hilo

Herramientas de monitoreo

• mattermost_run_monitoring : activa el proceso de monitoreo de temas inmediatamente

Herramientas de usuario

• mattermost_get_users : Obtener una lista de usuarios en el espacio de trabajo

• mattermost_get_user_profile : Obtener información detallada del perfil de un usuario

Configuración

1. Clonar este repositorio:

2. Instalar dependencias:

3. Configurar el servidor:

   El repositorio incluye un archivo config.json con valores de marcador de posición. Para la configuración, crea un archivo config.local.json (ignorado por git) con tus credenciales reales:

   { "mattermostUrl": "https://your-mattermost-instance.com/api/v4", "token": "your-personal-access-token", "teamId": "your-team-id", "monitoring": { "enabled": false, "schedule": "*/15 * * * *", "channels": ["town-square", "off-topic"], "topics": ["tv series", "champions league"], "messageLimit": 50 } }

   Este enfoque mantiene sus credenciales reales fuera del repositorio y al mismo tiempo conserva la plantilla para los demás.

4. Construir el servidor:

5. Ejecutar el servidor:

Configuración de monitoreo de temas

El sistema de monitorización se puede configurar con las siguientes opciones:

• enabled (booleano): si la monitorización está habilitada

• schedule (cadena): expresión cron para determinar cuándo verificar si hay mensajes nuevos (por ejemplo, "*/15 * * * *" cada 15 minutos)

• channels (cadena[]): Matriz de nombres de canales para monitorear

• topics (cadena[]): Matriz de temas a buscar en los mensajes

• messageLimit (número): Número de mensajes recientes a analizar por verificación

• notificationChannelId (cadena, opcional): ID del canal donde se enviarán las notificaciones. Si no se proporciona, el sistema usará automáticamente un canal de mensajes directos.

• userId (cadena, opcional): Su ID de usuario para menciones en notificaciones. Si no se proporciona, el sistema detectará automáticamente al usuario actual.

Para habilitar la monitorización, configure enabled como true en su archivo config.local.json .

Ejecución manual del monitoreo

Puede activar el proceso de supervisión manualmente de varias maneras:

1. Usando los scripts proporcionados :

   • ./run-monitoring-http.sh - Activa la monitorización a través de HTTP sin reiniciar el servidor (recomendado)

   • ./run-monitoring.sh - Inicia una nueva instancia de servidor con la monitorización habilitada

   • ./trigger-monitoring.sh : ejecuta el proceso de monitoreo y sale (útil para trabajos cron)

   • ./view-channel-messages.js <channel-name> [count] - Ver los últimos mensajes en un canal

   • ./analyze-channel.js <channel-name> [count] - Analizar las estadísticas de mensajes en un canal

   • ./get-last-message.js <channel-name> - Obtener el último mensaje de un canal

2. Usando la interfaz de línea de comandos (CLI) :

   • Mientras el servidor esté en ejecución, simplemente escriba uno de estos comandos en la terminal:

     • run - Ejecutar el proceso de monitoreo

     • monitor - Lo mismo que run

     • check - Lo mismo que run

   • Otros comandos disponibles:

     • help - Mostrar comandos disponibles

     • exit - Apagar el servidor

3. Usando la herramienta MCP :

   • Utilice la herramienta mattermost_run_monitoring a través de la interfaz MCP

   • Esto comprobará inmediatamente todos los canales configurados para sus temas de interés.

4. Usando las banderas de la línea de comandos :

   • Inicie el servidor con el indicador --run-monitoring : GXP6

   • Esto ejecutará el proceso de monitoreo inmediatamente después de que se inicie el servidor.

   • Agregue --exit-after-monitoring para salir una vez completado el proceso de monitoreo: GXP7

   • Esto es útil para ejecutar el proceso de monitoreo desde trabajos cron

Detalles de la herramienta

Herramientas de canal

mattermost_list_channels

• Enumerar canales públicos en el espacio de trabajo

• Entradas opcionales:

  • limit (número, predeterminado: 100, máximo: 200): Número máximo de canales a devolver

  • page (número, predeterminado: 0): Número de página para paginación

• Devuelve: Lista de canales con sus IDs e información

mattermost_get_channel_history

• Obtener mensajes recientes de un canal

• Entradas requeridas:

  • channel_id (cadena): El ID del canal

• Entradas opcionales:

  • limit (número, predeterminado: 30): Número de mensajes a recuperar

  • page (número, predeterminado: 0): Número de página para paginación

• Devuelve: Lista de mensajes con su contenido y metadatos

Herramientas de mensajes

mattermost_post_message

• Publicar un nuevo mensaje en un canal de Mattermost

• Entradas requeridas:

  • channel_id (cadena): El ID del canal donde se publicará

  • message (cadena): el texto del mensaje a publicar

• Devoluciones: Confirmación de publicación del mensaje e ID

mattermost_reply_to_thread

• Responder a un hilo de mensajes específico

• Entradas requeridas:

  • channel_id (cadena): El canal que contiene el hilo

  • post_id (cadena): ID del mensaje principal

  • message (cadena): El texto de respuesta

• Devoluciones: Confirmación de respuesta e ID

mattermost_add_reaction

• Agregar una reacción emoji a un mensaje

• Entradas requeridas:

  • channel_id (cadena): El canal que contiene el mensaje

  • post_id (cadena): ID del mensaje al que se debe reaccionar

  • emoji_name (cadena): nombre del emoji sin dos puntos

• Devoluciones: Confirmación de reacción

mattermost_get_thread_replies

• Obtener todas las respuestas en un hilo de mensajes

• Entradas requeridas:

  • channel_id (cadena): El canal que contiene el hilo

  • post_id (cadena): ID del mensaje principal

• Devuelve: Lista de respuestas con su contenido y metadatos

Herramientas de usuario

mattermost_get_users

• Obtener la lista de usuarios del espacio de trabajo con información básica del perfil

• Entradas opcionales:

  • limit (número, predeterminado: 100, máximo: 200): Máximo de usuarios a devolver

  • page (número, predeterminado: 0): Número de página para paginación

• Devuelve: Lista de usuarios con sus perfiles básicos

mattermost_get_user_profile

• Obtenga información detallada del perfil de un usuario específico

• Entradas requeridas:

  • user_id (cadena): el ID del usuario

• Devoluciones: Información detallada del perfil de usuario

Uso con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json :

Solución de problemas

Si encuentra errores de permisos, verifique que:

1. Su token de acceso personal tiene los permisos necesarios

2. El token se ha copiado correctamente a su configuración

3. La URL de Mattermost y el ID del equipo son correctos

Puntos finales HTTP

El servidor expone puntos finales HTTP para control remoto:

• Monitoreo de ejecución : http://localhost:3456/run-monitoring

  • Activa el proceso de monitoreo inmediatamente

  • Devuelve una respuesta JSON con información de éxito/error

• Comprobar estado : http://localhost:3456/status

  • Devuelve información sobre el servidor y el estado de monitorización.

  • Útil para controles de salud

Puede utilizar estos puntos finales con curl o cualquier cliente HTTP:

Scripts de utilidad

monitorización de ejecución http.sh

Este script activa el proceso de monitorización a través del punto final HTTP:

Esta es la forma recomendada de activar la monitorización manualmente ya que:

• No reinicia el servidor

• No interfiere con el monitoreo programado

• Funciona de forma fiable desde cualquier terminal

ver-canal-mensajes.js

Este script te permite ver los mensajes más recientes en cualquier canal:

El script mostrará:

• Información del canal (nombre, propósito, número total de mensajes)

• Los mensajes más recientes con marcas de tiempo y nombres de usuario

• Si el canal no existe, se enumerarán todos los canales disponibles.

analizar-canal.js

Este script proporciona estadísticas detalladas sobre los mensajes en un canal:

El script mostrará:

• Información del canal y metadatos

• Recuento total de mensajes (incluidos los mensajes del sistema)

• Desglose de los mensajes del usuario frente a los mensajes del sistema

• Recuento de mensajes por usuario

• Los mensajes más recientes en el canal

obtener-último-mensaje.js

Este script recupera solo el mensaje más reciente de un canal:

El script mostrará:

• El ID de usuario y el nombre de usuario del remitente

• La marca de tiempo del mensaje

• El contenido completo del mensaje

Licencia

Este servidor MCP tiene licencia MIT.