Zulip MCP Server

MCP办公协作

提供方 avisekrath · 包名 @modelcontextprotocol/inspector

办公协作 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursor
查看接入方式

一个将Zulip REST API功能作为工具暴露给LLM的模型上下文协议服务器,允许AI助手以编程方式与Zulip工作区交互。

一句话选型结论

按资料字段整理

Zulip MCP Server 属于办公协作类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式支持远程部署
GitHub 星标 7 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

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

能力标签

支持客户端

适用场景

AI集成JavaScript本地部署团队协作消息服务API工具自动化

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx @modelcontextprotocol/inspector npm start

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

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zulip MCP Server当前 未标注 stdio · 本地进程 支持远程部署 有 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

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

详细介绍

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

Zulip MCP服务器

一个模型上下文协议(MCP)服务器,它公开Zulip REST API功能作为LLM的工具。此服务器允许AI助手以编程方式与您的Zulip工作区进行交互。

特性

🔄 资源 (上下文数据)

  • 用户目录:浏览具有角色和状态的组织成员
  • 流目录:探索可用流和权限
  • 邮件格式指南:完整的Zulip markdown语法参考
  • 组织信息:服务器设置、策略和自定义表情符号
  • 用户组:可用于提及和权限的组

🛠️ 工具 (25个可用操作)

辅助工具(LLM友好发现)

  • search-users -在发送DM之前按姓名/电子邮件查找用户
  • get-started -测试连接并获取工作区概览

消息操作

  • send-message -发送到流媒体或直接消息
  • get-messages -使用高级过滤和搜索进行检索
  • get-message -获取特定消息的详细信息
  • upload-file -共享文件和图像
  • edit-message -修改内容或移动主题
  • delete-message -删除邮件(需要管理员权限)
  • get-message-read-receipts -检查谁阅读了消息
  • add-emoji-reaction -使用Unicode或自定义表情符号进行反应
  • remove-emoji-reaction -删除消息中的表情符号反应

预定邮件和草稿

  • create-scheduled-message -安排未来的消息
  • edit-scheduled-message -修改计划邮件
  • create-draft -创建新邮件草稿
  • get-drafts -检索已保存的草稿
  • edit-draft -更新草稿内容

流管理

  • get-subscribed-streams -列出用户的流订阅
  • get-stream-id -按名称获取流ID
  • get-stream-by-id -详细的流信息
  • get-topics-in-stream -浏览最近的主题

用户操作

  • get-users -列出组织成员
  • get-user-by-email -通过电子邮件查找用户
  • get-user -按ID获取详细的用户信息
  • update-status -设置状态消息和可用性
  • get-user-groups -列出可用用户组

📝 Zulip术语:流与通道

在Zulip, “流” 和 “频道” 参考相同的概念:

  • 流 =Zulip官方术语(用于API、工具、界面)
  • 频道 =来自Slack/Discord/Teams的常用术语
  • 同样的事情 =团队讨论主题的对话空间

此MCP服务器使用“流”来匹配Zulip的官方文档和API。

安装和设置

先决条件

  • Node.js 18+与npm
  • TypeScript 5+
  • 访问Zulip实例(例如。,https://your-organization.zulipchat.com)
  • Zulip API证书(机器人程序令牌或API密钥)

快速开始

  1. 克隆和安装依赖关系:```bash
    git clone
    cd zulip-mcp-server
    npm install

2. **配置环境变量:**```bash
cp .env.example .env
# Edit .env with your Zulip credentials
  1. 构建并运行:```bash
    npm run build
    npm start

### 环境配置

创建一个 `.env` 使用您的Zulip凭据文件:```env
ZULIP_URL=https://your-organization.zulipchat.com
ZULIP_EMAIL=your-bot-email@yourcompany.com
ZULIP_API_KEY=your-api-key-here
NODE_ENV=production

获取Zulip API证书

  1. 用于Bot访问 (推荐):
  • 转到您的Zulip组织设置
  • 导航到“机器人”部分
  • 创建新的机器人或使用现有的机器人
  • 复制机器人程序电子邮件和API密钥
  1. 用于个人访问:
  • 转到个人设置→ 帐户和隐私
  • 查找“API密钥”部分
  • 生成或显示您的API密钥

Claude桌面集成

要将此MCP服务器与Claude Desktop一起使用,请将以下配置添加到您的Claude Desktop配置文件中:

选项1:使用环境变量(推荐)

添加到您的Claude Desktop配置中:```json
{
"mcpServers": {
"zulip": {
"command": "node",
"args": ["/path/to/zulip-mcp-server/dist/server.js"],
"env": {
"ZULIP_URL": "https://your-organization.zulipchat.com",
"ZULIP_EMAIL": "your-bot-email@yourcompany.com",
"ZULIP_API_KEY": "your-api-key-here"
}
}
}
}


#### 选项2:使用.env文件

如果你更喜欢使用 `.env` 文件,确保它在项目目录中并使用:```json
{
"mcpServers": {
"zulip": {
"command": "node",
"args": ["/path/to/zulip-mcp-server/dist/server.js"],
"cwd": "/path/to/zulip-mcp-server"
}
}
}

Claude桌面配置位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json

光标集成

要将此MCP服务器与Cursor IDE一起使用,请在Cursor MCP设置中添加以下内容:

光标MCP配置

添加到Cursor的MCP设置文件(.cursor-mcp/config.json 在您的工作区或全局设置中):```json
{
"mcpServers": {
"zulip": {
"command": "node",
"args": ["/path/to/zulip-mcp-server/dist/server.js"],
"env": {
"ZULIP_URL": "https://your-organization.zulipchat.com",
"ZULIP_EMAIL": "your-bot-email@yourcompany.com",
"ZULIP_API_KEY": "your-api-key-here"
},
"capabilities": {
"tools": true,
"resources": true
}
}
}
}


**光标MCP配置位置:**

- **工作区**: `.cursor-mcp/config.json` 在项目根目录中
- **全球**:特定于平台的游标设置目录

### Raycast MCP扩展

要将此MCP服务器与Raycast一起使用,请在MCP扩展设置中进行配置:

#### Raycast MCP配置

添加到Raycast MCP扩展配置:```json
{
"servers": {
"zulip": {
"name": "Zulip Integration",
"description": "Send messages and interact with Zulip workspace",
"command": "node",
"args": ["/path/to/zulip-mcp-server/dist/server.js"],
"env": {
"ZULIP_URL": "https://your-organization.zulipchat.com",
"ZULIP_EMAIL": "your-bot-email@yourcompany.com",
"ZULIP_API_KEY": "your-api-key-here"
},
"icon": "💬",
"categories": ["communication", "productivity"]
}
}
}

光线投射设置步骤:

  1. 安装Raycast MCP扩展
  2. 打开“光线投射”首选项→ 扩展→ MCP
  3. 添加新的服务器配置
  4. 粘贴上面的JSON配置
  5. 相应地更新路径和凭据

Raycast用法:

  • 使用 ⌘ + Space 打开Raycast
  • 搜索“Zulip”命令
  • 直接从Raycast界面执行MCP工具

支持的MCP客户端

此服务器与任何符合MCP的客户端兼容。以下是经过验证的集成:

平台 配置类型 状态 使用情况
克劳德桌面 JSON配置 ✅ 已验证 与Zulip集成的AI对话
光标IDE 工作区/全局配置 ✅ 已验证 带有Zulip通知的代码编辑器
光线投射 扩展配置 ✅ 已验证 快速命令和自动化
其他MCP客户端 标准MCP协议 🔄 兼容 任何符合MCP的应用程序

通用MCP命令:```bash
node /path/to/zulip-mcp-server/dist/server.js


## 发展

### 脚本```bash
npm run dev          # Development with hot reload
npm run build        # Build for production
npm test            # Run tests
npm run lint        # Lint TypeScript
npm run typecheck   # Type checking

项目结构```

src/
├── server.ts # Main MCP server
├── zulip/
│ └── client.ts # Zulip API client
└── types.ts # TypeScript definitions


### 测试

使用MCP检查器测试服务器:```bash
npx @modelcontextprotocol/inspector npm start

使用示例

发送消息```typescript

// Send to a stream
await callTool("send-message", {
type: "stream",
to: "general",
topic: "Daily Standup",
content: "Good morning team! 👋\n\nToday's Goals:\n- Review PR #123\n- Deploy feature X"
});

// Direct message
await callTool("send-message", {
type: "direct",
to: "user@example.com",
content: "Hey! Can you review the latest changes when you have a moment?"
});


### 获取消息```typescript
// Get recent messages from a stream
await callTool("get-messages", {
narrow: [["stream", "general"], ["topic", "announcements"]],
num_before: 50
});

// Search messages
await callTool("get-messages", {
narrow: [["search", "deployment"], ["sender", "admin@example.com"]]
});

流管理```typescript

// List subscribed streams
await callTool("get-subscribed-streams", {
include_subscribers: true
});

// Get stream topics
await callTool("get-topics-in-stream", {
stream_id: 123
});
```

Markdown格式支持

服务器包括一个全面的格式化指南资源。Zulip支持:

  • 标准Markdown:粗体、斜体、代码、链接、列表
  • 提及: @**Full Name** (通知), @_**Name**_ (无声)
  • 流链接: #**stream-name**
  • 代码块:带有语法高亮显示
  • 数学:LaTeX表达式 $$math$$
  • 剧透: · hidden content ·
  • 自定义表情符号:特定于组织的表情符号

错误处理

服务器提供全面的错误处理:

  • 网络连接问题
  • 身份验证失败
  • 权限错误
  • 速率限制
  • 无效参数
  • Zulip API错误

所有错误都包含有助于调试的消息。

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 添加新功能的测试
  4. 确保TypeScript编译通过
  5. 提交拉取请求

支持

对于问题和疑问:

  • 查看Zulip API文档:https://zulip.com/api/
  • 审查MCP规范:https://modelcontextprotocol.io/
  • 打开GitHub问题以查找错误或功能请求

常见问题

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

在客户端按下面的安装命令接入:npx @modelcontextprotocol/inspector npm start。对应的包名是 @modelcontextprotocol/inspector。装完在客户端配置里引用同一个包或端点。

Zulip MCP Server 怎么在 Claude Desktop、Claude、Cursor 里配置?

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

Zulip MCP Server 收费吗?

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

Zulip MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Zulip MCP Server 支持哪些客户端?

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

Zulip MCP Server 能提供哪些能力?

资料显示能力标签包括 团队协作、JavaScript、Claude、API集成。具体工具清单以官方文档为准。

Zulip MCP Server 需要什么运行环境?

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

Zulip MCP Server 是本地还是远程?

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

热门专题

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

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