Zulip MCP 服务器

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

工具

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

Related MCP server: Hass-MCP

设置

创建 Zulip 机器人：
- 登录您的 Zulip 实例
- 导航至“设置”>“个人”>“机器人”
- 点击“添加新机器人”
- 选择“通用机器人”类型
- 填写所需信息
- 点击“创建机器人”
权限：
- 默认情况下，Zulip 机器人的权限有限
- 确保为机器人订阅它需要访问的任何流
- 如果您需要机器人拥有更多权限，请考虑使用完整用户帐户
获取 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" } } } }

码头工人

{ "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" } } } }