Zulip MCP Server

Zulip MCP 服务器

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

工具

1. zulip_list_channels
   • 列出 Zulip 组织中的可用频道（流）
   • 可选输入：
     • include_private （布尔值，默认值：false）：是否包含私有流
     • include_web_public (布尔值，默认值：true)：是否包含网络公共流
     • include_subscribed （布尔值，默认值：true）：是否包含机器人订阅的流
   • 返回：流及其 ID 和信息的列表
2. zulip_post_message
   • 向 Zulip 频道（流）发布新消息
   • 必需输入：
     • channel_name （字符串）：要发布到的流的名称
     • topic （字符串）：流中的主题
     • content （字符串）：要发布的消息内容
   • 返回：消息发布确认和ID
3. zulip_send_direct_message
   • 向一个或多个用户发送直接消息
   • 必需输入：
     • recipients （string[]）：收件人的电子邮件地址或用户 ID
     • content （字符串）：要发送的消息内容
   • 返回：消息发送确认和ID
4. zulip_add_reaction
   • 在消息中添加表情符号反应
   • 必需输入：
     • message_id （数字）：需要响应的消息的 ID
     • emoji_name （字符串）：不带冒号的表情符号名称
   • 返回：反应确认
5. zulip_get_channel_history
   • 从频道（流）和主题获取最新消息
   • 必需输入：
     • channel_name （字符串）：流的名称
     • topic （字符串）：主题名称
   • 可选输入：
     • limit （数字，默认值：20）：要检索的消息数量
     • anchor （字符串，默认值：“最新”）：从中开始的消息 ID
   • 返回：消息及其内容和元数据的列表
6. zulip_get_topics
   • 获取频道（流）中的主题
   • 必需输入：
     • channel_id （数字）：流的ID
   • 返回：流中的主题列表
7. zulip_subscribe_to_channel
   • 将机器人订阅到频道（流）
   • 必需输入：
     • channel_name (string)：要订阅的流的名称
   • 返回：订阅确认
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

码头工人

故障排除

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

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

建造

Docker 构建：

执照

此 MCP 服务器根据 MIT 许可证获得许可。