Zulip MCP 服务器

Zulip 的 MCP（机器上下文协议）服务器为 Zulip API 提供支持，使 AI 助手如 Claude 能够与 Zulip 工作区交互。

工具

1. zulip_list_channels

   • 列出组织中的可用频道（流）
   • 可选输入：
     • include_private (boolean, 默认: false): 是否包含私有流
     • include_web_public (boolean, 默认: true): 是否包含对网页公开的流
     • include_subscribed (boolean, 默认: true): 是否包含机器人已订阅的流
   • 返回：包含 ID 和信息的流列表

2. zulip_post_message

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

3. zulip_send_direct_message

   • 向一个或多个用户发送直接消息
   • 必需输入：
     • recipients (string[]): 收件人的电子邮件地址或用户 ID
     • content (string): 发送的消息内容
   • 返回：确认消息发送和 ID

4. zulip_add_reaction

   • 在某条消息上添加表情符号反应
   • 必需输入：
     • message_id (number): 要回复的消息 ID
     • emoji_name (string): 无冒号的表情符号名称
   • 返回：确认反应

5. zulip_get_channel_history

   • 从频道（流）和主题获取最近消息
   • 必需输入：
     • channel_name (string): 流的名称
     • topic (string): 主题名称
   • 可选输入：
     • limit (number, 默认: 20): 要检索的消息数量
     • anchor (string, 默认: "newest"): 起始点消息 ID
   • 返回：包含内容和元数据的消息列表

6. zulip_get_topics

   • 获取频道（流）中的主题列表
   • 必需输入：
     • channel_name (string): 流的名称
   • 返回：确认反应

7. zulip_join_channel

   • 加入一个频道
   • 必需输入：
     • channel_name (string): 要加入的流名称
   • 返回：确认加入频道

8. zulip_leave_channel

   • 退出一个频道
   • 必需输入：
     • channel_name (string): 要退出的流名称
   • 返回：确认退出频道

设置

创建 Zulip 机器人

1. 登录您的 Zulip 组织。
2. 访问 Zulip 管理 页面。
3. 点击“创建新机器人”按钮。
4. 配置机器人设置，如机器人名称和邮件地址。
5. 生成并记录 API 密钥。

配置权限

确保机器人具备以下权限：

• 读取权限: 允许机器人查看频道内容。
• 写入权限: 允许机器人发送消息。
• 管理权限（可选）: 允许机器人管理其他用户或频道。

使用说明

与 Claude Desktop 集成

使用 npx 运行

在终端中运行以下命令：

npx mcp-server zulip --url YOUR_ZULIP_URL --token YOUR_API_KEY

使用 Docker 运行

构建镜像并运行容器：

docker build -t mcp/zulip .
docker run -it --rm mcp/zulip --url YOUR_ZULIP_URL --token YOUR_API_KEY

配置示例

npx 方法

编辑 claude_desktop_config.json 文件，添加以下内容：

{
  "mcpServers": [
    {
      "command": "npx",
      "args": ["mcp-server", "zulip"],
      "env": {
        "ZULIP_URL": "https://your-org.zulip.com",
        "ZULIP_TOKEN": "your_api_key_here"
      }
    }
  ]
}

Docker 方法

编辑 claude_desktop_config.json 文件，添加以下内容：

{
  "mcpServers": [
    {
      "command": "docker",
      "args": ["run", "-it", "--rm", "mcp/zulip"],
      "env": {
        "ZULIP_URL": "https://your-org.zulip.com",
        "ZULIP_TOKEN": "your_api_key_here"
      }
    }
  ]
}

故障排除

遇到权限错误时，请检查：

1. 确保 API 密钥正确无误。
2. 确认机器人已订阅需要访问的频道。
3. 确保 Zulip URL 正确且可访问。

构建

使用以下命令构建 Docker 镜像：

docker build -t mcp/zulip .

许可证

此 MCP 服务器在 MIT 许可证下发行。