Zulip MCP Server

Interactúa con espacios de trabajo de Zulip usando la API de Zulip.

GitHub
12
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Zulip

Servidor MCP para la API de Zulip, que permite a asistentes de IA como Claude interactuar con espacios de trabajo de Zulip.

Herramientas

  1. zulip_list_channels

    • Lista los canales disponibles (flujos) en la organización de Zulip
    • Entradas opcionales:
      • include_private (booleano, predeterminado: falso): Si se deben incluir flujos privados
      • include_web_public (booleano, predeterminado: verdadero): Si se deben incluir flujos públicos web
      • include_subscribed (booleano, predeterminado: verdadero): Si se deben incluir flujos a los que el bot está suscrito
    • Devuelve: Lista de flujos con sus IDs e información

  2. zulip_post_message

    • Publica un nuevo mensaje en un canal (flujo) de Zulip
    • Entradas requeridas:
      • channel_name (cadena): El nombre del flujo donde publicar
      • topic (cadena): El tema dentro del flujo
      • content (cadena): El contenido del mensaje a publicar
    • Devuelve: 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 IDs de usuario de los destinatarios
      • content (cadena): El contenido del mensaje a enviar
    • Devuelve: Confirmación de envío del mensaje e ID

  4. zulip_add_reaction

    • Agrega una reacción de emoji a un mensaje
    • Entradas requeridas:
      • message_id (número): El ID del mensaje al que reaccionar
      • emoji_name (cadena): Nombre del emoji sin dos puntos
    • Devuelve: Confirmación de la reacción

  5. zulip_get_channel_history

    • Obtiene mensajes recientes de un canal (flujo) y tema
    • Entradas requeridas:
      • channel_name (cadena): El nombre del flujo
      • topic (cadena): El nombre del tema
    • Entradas opcionales:
      • limit (número, predeterminado: 20): Cantidad de mensajes a recuperar
      • anchor (cadena, predeterminado: "newest"): ID del mensaje desde donde comenzar
    • Devuelve: Lista de mensajes con su contenido y metadatos

  6. zulip_get_topics

    • Obtiene temas en un canal (flujo)
    • Entradas requeridas:
      • channel_id (número): El ID del flujo
    • Devuelve: Lista de temas en el flujo

  7. zulip_subscribe_to_channel

    • Suscribe el bot a un canal (flujo)
    • Entradas requeridas:
      • channel_name (cadena): El nombre del flujo al que suscribirse
    • Devuelve: Confirmación de suscripción

  8. zulip_get_users

    • Obtiene la lista de usuarios en la organización de Zulip
    • Devuelve: Lista de usuarios con su información básica

Configuración

  1. Crear un bot de Zulip:

    • Inicia sesión en tu instancia de Zulip
    • Navega a Configuración > Personal > Bots
    • Haz clic en "Agregar un nuevo bot"
    • Selecciona el tipo "Bot genérico"
    • Completa la información requerida
    • Haz clic en "Crear bot"

  2. Permisos:

    • Por defecto, los bots de Zulip tienen permisos limitados
    • Asegúrate de suscribir el bot a cualquier flujo que necesite acceder
    • Si necesitas que el bot tenga más permisos, considera usar una cuenta de usuario completa en su lugar

  3. Obtén las credenciales de la API:

    • Dirección de correo electrónico del bot
    • Clave de API del bot (se muestra al crear el bot)
    • URL de la instancia de Zulip (por ejemplo, https://example.zulipchat.com)

Uso con Claude Desktop

Agrega lo siguiente a tu claude_desktop_config.json:

npx

{
  "mcpServers": {
    "zulip": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-zulip"
      ],
      "env": {
        "ZULIP_EMAIL": "your-bot@example.zulipchat.com",
        "ZULIP_API_KEY": "your-bot-api-key",
        "ZULIP_URL": "https://example.zulipchat.com"
      }
    }
  }
}

docker

{
  "mcpServers": {
    "zulip": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ZULIP_EMAIL",
        "-e",
        "ZULIP_API_KEY",
        "-e",
        "ZULIP_URL",
        "mcp/zulip"
      ],
      "env": {
        "ZULIP_EMAIL": "your-bot@example.zulipchat.com",
        "ZULIP_API_KEY": "your-bot-api-key",
        "ZULIP_URL": "https://example.zulipchat.com"
      }
    }
  }
}

Solución de problemas

Si encuentras errores de permisos, verifica que:

  1. La clave de API del bot sea correcta
  2. El bot haya sido suscrito a los canales que necesita acceder
  3. La URL de Zulip sea correcta y accesible

Compilación

Compilación de Docker:

docker build -t mcp/zulip .

Licencia

Copyright 2025 Monadical

Licenciado bajo la Licencia Apache, Versión 2.0 (la "Licencia"); no puedes usar este archivo excepto en cumplimiento con la Licencia. Puedes obtener una copia de la Licencia en

http://www.apache.org/licenses/LICENSE-2.0

Salvo que lo exija la ley aplicable o se acuerde por escrito, el software distribuido bajo la Licencia se distribuye "TAL CUAL", SIN GARANTÍAS NI CONDICIONES DE NINGÚN TIPO, ya sean expresas o implícitas. Consulta la Licencia para conocer los permisos y limitaciones específicos bajo la Licencia.

Este producto incluye componentes de software de terceros. Consulta los archivos LICENSE y NOTICE para más detalles.