ZulipChat MCP

MCPAI代理

提供方 akougkas

AI代理 stdio · 本地进程 会话登录 社区 / 第三方 ClaudeCursorWindsurfVS Code
查看接入方式

ZulipChat MCP服务器是一个协议服务器,用于连接各种MCP兼容的AI助手到Zulip聊天平台,实现消息收发、搜索、用户解析等功能。

一句话选型结论

按资料字段整理

ZulipChat MCP 属于AI代理类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude、Cursor、Windsurf 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 14 仓库热度,无公开仓库时显示未标注
工具数 20 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量20暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

聊天集成Python本地部署AI助手消息处理协议服务器Zulip扩展

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
uvx zulipchat-mcp --zulip-config-file ~/.zuliprc

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 20 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 20 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、Windsurf,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
ZulipChat MCP当前 20 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方akougkas上游标注的维护方 akougkas
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.4 KB
来自项目仓库与上游目录的原文,未做删改

ZulipChat MCP服务器

Model Context Protocol server for Zulip Chat. Connect Claude Code, Gemini CLI, Codex, Cursor, Windsurf, VS Code Copilot, and other MCP clients to Zulip.


快速开始```bash

uvx zulipchat-mcp --zulip-config-file ~/.zuliprc


就是这样。你的人工智能助手现在可以读写Zulip消息了。

需要zulipc吗? **Zulip设置>个人>帐户和隐私>API密钥** --下载文件,另存为 `~/.zuliprc`.

互动式入职培训:```bash
uvx --from zulipchat-mcp zulipchat-mcp-setup

这有什么作用

ZulipChat MCP将任何兼容MCP的AI助手(Claude Code、Gemini CLI、Cursor、Windsurf等)连接到您的Zulip工作区。助理可以:

  • 发送和阅读消息 --流式消息、DM、回复、反应
  • 搜索对话历史记录 --使用发件人、流、时间范围筛选器进行全文搜索
  • 按名称解析人员 --“消息詹姆”只是有效的,不需要寻找正式的电子邮件
  • 交换机标识 --在同一会话中以自己或机器人的身份发布
  • 监督活动 --搜索最近的消息,获取流信息,检查谁在线
  • 将会话绑定到Zulip主题 --为长时间运行的代理会话提供一个稳定的控制主题
  • 请求主题中的批准 --所有者回复如下 approve / deny 在会议主题中

两层工具架构

v0.6.0引入了一个深思熟虑的拆分: 20个核心工具 默认情况下, 56工具 当你需要更多的时候。

核心模式(默认)

涵盖大多数日常使用的20种工具:

类别 工具
消息传递 send_message, edit_message, get_message, add_reaction
搜索 search_messages, get_streams, get_stream_info, get_stream_topics
用户 resolve_user, get_users, get_own_user
代理通信 teleport_chat, register_agent, ensure_agent_session, agent_message, request_user_input, wait_for_response
系统 switch_identity, server_info, manage_message_flags

为什么是20而不是56?更少的工具意味着更快的工具选择、更低的令牌开销和更少的人工智能混淆。大多数任务——发送消息、搜索、反应和将代理会话绑定到Zulip——只需要核心集。

扩展模式

需要定时消息、事件队列、文件上传、分析或高级搜索?```bash
uvx zulipchat-mcp --zulip-config-file ~/.zuliprc --extended-tools


或者通过环境变量:```bash
ZULIPCHAT_EXTENDED_TOOLS=1 uvx zulipchat-mcp --zulip-config-file ~/.zuliprc

扩展模式增加了: toggle_reaction, cross_post_message, advanced_search, construct_narrow, get_scheduled_messages, manage_scheduled_message, register_events, get_events, listen_events, upload_file, manage_files, get_daily_summary, manage_user_mute, get_user, get_presence, get_user_groups以及更多。

安装

完整的每个客户端设置指南: docs/integrations/README.md

克劳德代码```bash

claude mcp add zulipchat -- uvx zulipchat-mcp --zulip-config-file ~/.zuliprc


双重身份(你+机器人):```bash
claude mcp add zulipchat -- uvx zulipchat-mcp \
--zulip-config-file ~/.zuliprc \
--zulip-bot-config-file ~/.zuliprc-bot

可选的克劳德钩桥,用于生命周期和审批流程:```bash
uvx zulipchat-mcp-hook \
--zulip-config-file ~/.zuliprc \
--zulip-bot-config-file ~/.zuliprc-bot


可选的Claude包导出,用于项目本地钩子、技能和子代理:```bash
uvx zulipchat-mcp-integrate export \
--client claude-code \
--mode standalone \
--output-dir . \
--zulip-config-file ~/.zuliprc \
--zulip-bot-config-file ~/.zuliprc-bot

Gemini CLI

添加 ~/.gemini/settings.json 在...之下 mcpServers:```json
{
"zulipchat": {
"command": "uvx",
"args": ["zulipchat-mcp", "--zulip-config-file", "/path/to/.zuliprc"]
}
}


### 克劳德桌面/光标/任何MCP客户端

添加到MCP配置中:```json
{
"mcpServers": {
"zulipchat": {
"command": "uvx",
"args": ["zulipchat-mcp", "--zulip-config-file", "/path/to/.zuliprc"]
}
}
}

配置选项

选项 描述
--zulip-config-file PATH zulipc文件的路径
--zulip-bot-config-file PATH Bot zulipc用于双重身份
--extended-tools 注册所有56个工具,而不是20个工具核心集
--unsafe 启用管理工具(谨慎使用)
--debug 启用调试日志记录

更多客户

专用设置页面:

  • Gemini CLI
  • 法典
  • OpenCode
  • VS代码+GitHub副本
  • 光标
  • 帆板运动
  • 反重力
  • 通用MCP

双重身份

配置一个用户和一个bot-zulipc,让你的助手在会话中在身份之间切换:```bash
uvx zulipchat-mcp \
--zulip-config-file ~/.zuliprc \
--zulip-bot-config-file ~/.zuliprc-bot


助理职位如下 **你** 默认情况下。呼叫 `switch_identity` 以机器人身份发布——适用于自动通知、代理间通信,或保持人类与机器人消息的区别。

## 真实世界的例子

**“跟我聊聊今天#engineering发生了什么”**
→ 助理电话 `search_messages` 使用流+时间过滤器,总结线程。

**“告诉团队我们将在下午3点部署”**
→ 助理电话 `send_message` 以#engineering的名义宣布。

**“是谁发送了关于API迁移的消息?”**
→ 助理电话 `search_messages` 使用关键字,返回发件人和上下文。

**“使用:thumbs_up:响应Sarah的最后一条消息”**
→ 助理电话 `resolve_user` (“莎拉”), `search_messages` (发送者),那么 `add_reaction`.

**“DM Jaime,公关准备就绪”**
→ 助理电话 `teleport_chat` 具有模糊名称解析功能,无需电子邮件。

## 发展```bash
git clone https://github.com/akougkas/zulipchat-mcp.git
cd zulipchat-mcp
uv sync
uv run zulipchat-mcp --zulip-config-file ~/.zuliprc

运行检查:```bash
uv run pytest -q # full test suite, 60% coverage gate
uv run ruff check . # Linting
uv run mypy src # Type checking


对于打包、依赖关系、FastMCP或启动更改,请运行releasesmoke:```bash
uv build
scripts/pre_release_smoke.sh --version X.Y.Z --allow-dirty

看 贡献.md 获取完整指南,以及 CLAUDE.md / 代理商.md 获取AI代理指令。

建筑```

src/zulipchat_mcp/
├── core/ # Client wrapper, identity, caching, security
├── tools/ # MCP tool implementations (two-tier registration)
├── services/ # Background listener and session event routing
├── utils/ # Logging, DuckDB persistence, metrics
└── config.py # config loading (zuliprc + environment fallback)
```

建于 FastMCP 采用异步优先设计, DuckDB 用于代理状态持久性,以及用于快速模糊解析的智能用户/流缓存。

隐私

  • 无数据收集 -除了Zulip API调用之外,没有任何东西离开您的计算机
  • 无遥测 --零分析、跟踪或使用报告
  • 本地执行 --所有处理都发生在您的硬件上
  • 凭证保留在本地 -API密钥不会被记录或传输到Zulip服务器之外

完整政策: 隐私.md

许可证

麻省理工学院——见 许可证

链接

  • 文档索引
  • 支持
  • 安全策略
  • Zulip API文档
  • 模型上下文协议
  • 报告问题
  • 讨论

Built for the Zulip community

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
ZulipChat MCP 怎么安装?

在客户端按下面的安装命令接入:uvx zulipchat-mcp --zulip-config-file ~/.zuliprc。装完在客户端配置里引用同一个包或端点。

ZulipChat MCP 怎么在 Claude、Cursor、Windsurf 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

ZulipChat MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

ZulipChat MCP 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

ZulipChat MCP 支持哪些客户端?

资料标注支持 Claude、Cursor、Windsurf、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

ZulipChat MCP 能提供哪些能力?

资料显示约 20 个工具;能力标签包括 Python、Claude、AI代理。具体工具清单以官方文档为准。

ZulipChat MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

ZulipChat MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。