Zulip MCP 服务器

用于 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 (数字，默认值：20)：要检索的消息数量
     • 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 .

许可证

此 MCP 服务器已获得 MIT 许可证的许可。