Servidor MCP de Zulip

Servidor MCP para la API de Zulip, que permite que los asistentes de IA como Claude interactúen con los espacios de trabajo de Zulip.

Herramientas

1. zulip_list_channels

   • Enumere los canales (transmisiones) disponibles en la organización Zulip

   • Entradas opcionales:

     • include_private (booleano, valor predeterminado: falso): si se deben incluir transmisiones privadas

     • include_web_public (booleano, valor predeterminado: verdadero): si se deben incluir transmisiones web públicas

     • include_subscribed (booleano, valor predeterminado: verdadero): si se deben incluir las transmisiones a las que está suscrito el bot

   • Devuelve: Lista de transmisiones con sus identificaciones e información

2. zulip_post_message

   • Publicar un nuevo mensaje en un canal de Zulip (transmisión)

   • Entradas requeridas:

     • channel_name (cadena): El nombre de la transmisión en la que se publicará

     • topic (cadena): El tema dentro de la secuencia

     • content (cadena): el contenido del mensaje a publicar

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

3. zulip_send_direct_message

   • Envía un mensaje directo a uno o más usuarios

   • Entradas requeridas:

     • recipients (cadena[]): direcciones de correo electrónico o ID de usuario de los destinatarios

     • content (cadena): El contenido del mensaje a enviar

   • Devoluciones: Confirmación de envío del mensaje e ID

4. zulip_add_reaction

   • Agregar una reacción emoji a un mensaje

   • Entradas requeridas:

     • message_id (número): El ID del mensaje al que se debe reaccionar

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

   • Devoluciones: Confirmación de reacción

5. zulip_get_channel_history

   • Obtener mensajes recientes de un canal (transmisión) y tema

   • Entradas requeridas:

     • channel_name (cadena): El nombre de la transmisión

     • topic (cadena): el nombre del tema

   • Entradas opcionales:

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

     • anchor (cadena, valor predeterminado: "más nuevo"): ID del mensaje desde el que comenzar

   • Devuelve: Lista de mensajes con su contenido y metadatos

6. zulip_get_topics

   • Obtener temas en un canal (transmisión)

   • Entradas requeridas:

     • channel_id (número): El ID de la transmisión

   • Devuelve: Lista de temas en la secuencia

7. zulip_subscribe_to_channel

   • Suscribir el bot a un canal (transmisión)

   • Entradas requeridas:

     • channel_name (cadena): el nombre de la transmisión a la que suscribirse

   • Devoluciones: Confirmación de suscripción

8. zulip_get_users

   • Obtener la lista de usuarios de la organización Zulip

   • Devuelve: Listado de usuarios con su información básica

Configuración

1. Crear un bot Zulip:

   • Inicie sesión en su instancia de Zulip

   • Vaya a Configuración > Personal > Bots

   • Haga clic en "Agregar un nuevo bot"

   • Seleccione el tipo "Bot genérico"

   • Complete la información requerida

   • Haga clic en "Crear bot"

2. Permisos:

   • De forma predeterminada, los bots de Zulip tienen permisos limitados

   • Asegúrate de suscribir el bot a todas las transmisiones a las que necesita acceder.

   • Si necesita que el bot tenga más permisos, considere usar una cuenta de usuario completa en su lugar

3. Obtenga las credenciales de la API:

   • Dirección de correo electrónico del bot

   • Clave API del bot (se muestra cuando creas el bot)

   • URL de instancia de Zulip (por ejemplo, https://example.zulipchat.com )

Uso con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json :

npx

estibador

Solución de problemas

Si encuentra errores de permisos, verifique que:

1. La clave API del bot es correcta

2. El bot se ha suscrito a los canales a los que necesita acceder.

3. La URL de Zulip es correcta y accesible

Construir

Compilación de Docker:

Licencia

Este servidor MCP tiene licencia MIT.