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 许可证获得许可。