Zulip MCP Server

用于Zulip API的MCP服务器，使像Claude这样的AI助手能够与Zulip工作区进行交互。

工具

1. zulip_list_channels

   • 列出Zulip组织中的可用频道（流）
   • 可选输入：
     • include_private（布尔值，默认：false）：是否包含私有流
     • include_web_public（布尔值，默认：true）：是否包含Web公开流
     • include_subscribed（布尔值，默认：true）：是否包含机器人订阅的流
   • 返回：带有ID和信息的流列表

2. zulip_post_message

   • 向Zulip频道（流）发布新消息
   • 必需输入：
     • channel_name（字符串）：要发布的流名称
     • topic（字符串）：流内的主题
     • content（字符串）：要发布的消息内容
   • 返回：消息发布确认和ID

3. zulip_send_direct_message

   • 向一个或多个用户发送直接消息
   • 必需输入：
     • recipients（字符串数组）：收件人的电子邮件地址或用户ID
     • content（字符串）：要发送的消息内容
   • 返回：消息发送确认和ID

4. zulip_add_reaction

   • 向消息添加表情反应
   • 必需输入：
     • message_id（数字）：要反应的消息ID
     • emoji_name（字符串）：不带冒号的表情符号名称
   • 返回：反应确认

5. zulip_get_channel_history

   • 获取来自频道（流）和主题的最近消息
   • 必需输入：
     • channel_name（字符串）：流的名称
     • topic（字符串）：主题名称
   • 可选输入：
     • limit（数字，默认：220）：要检索的消息数量
     • anchor（字符串，默认：“newest”）：开始的消息ID
   • 返回：带有内容和元数据的消息列表

6. zulip_get_topics

   • 获取频道（流）中的主题
   • 必需输入：
     • channel_id（数字）：流的ID
   • 返回：流中的主题列表

7. zulip_subscribe_to_channel

   • 订阅机器人到频道（流）
   • 必需输入：
     • channel_name（字符串）：要订阅的流名称
   • 返回：订阅确认

8. zulip_get_users

   • 获取Zulip组织中的用户列表
   • 返回：带有基本信息的用户列表

配置

1. 创建Zulip机器人：

   • 登录您的Zulip实例
   • 导航至设置 > 个人 > 机器人
   • 点击“添加新机器人”
   • 选择“通用机器人”类型
   • 填写所需信息
   • 点击“创建机器人”

2. 权限：

   • 默认情况下，Zulip机器人具有有限权限
   • 确保将机器人订阅到其需要访问的任何流
   • 如果需要机器人拥有更多权限，请考虑使用完整的用户帐户

3. 获取API凭证：

   • 机器人的电子邮件地址
   • 机器人的API密钥（在创建机器人时显示）
   • Zulip实例URL（例如，https://example.zulipchat.com）

使用Claude Desktop

在您的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"
      }
    }
  }
}

故障排除

如果您遇到权限错误，请验证：

1. 机器人的API密钥是否正确
2. 机器人是否已订阅到其需要访问的频道
3. Zulip URL是否正确且可访问

构建

Docker构建：

docker build -t mcp/zulip .

许可证

版权所有 2025 Monadical

根据Apache许可证，版本2.0（“许可证”）获得许可； 除非符合许可证，否则不得使用此文件。 您可以通过以下方式获取许可证副本：

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

除非适用法律要求或书面同意，否则根据许可证分发的软件 按“原样”基础分发， 没有任何明示或暗示的保证或条件。 请参阅许可证以了解具体规定了权限和限制的条款。

本产品包括第三方软件组件。详情请参见LICENSE和NOTICE文件。