关于 Yuva
Yuva 是面向管理多个产品支持团队的开源客户消息平台，将共享收件箱与内容发布、邮件营销和分析整合在一起，并可部署在团队自己的服务器上。
主要功能
- 01统一处理邮件与聊天
- 02团队邮箱、搜索与草稿
- 03邮件列表和活动报告
- 04发布帮助中心与状态页
- 05对话和网站分析
- 06REST API、Webhook 与 MCP 服务
适用场景
- 01处理多个产品的支持对话
- 02起草并审核客户回复
- 03发布帮助内容和状态页
- 04分析响应时间与支持趋势
MCP 相关
Yuva 提供带 OAuth 的 MCP 服务，可连接 Claude、Cursor 和 VS Code 等 AI 助手，使其使用客户消息功能。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://{yuva_host}/mcpclaude mcp add --transport http productdevbook-yuva https://{yuva_host}/mcp{"mcpServers":{"productdevbook-yuva":{"type":"http","url":"https://{yuva_host}/mcp"}}}在 Cursor 中打开{"servers":{"productdevbook-yuva":{"type":"http","url":"https://{yuva_host}/mcp"}}}在 VS Code 中打开{"mcpServers":{"productdevbook-yuva":{"type":"http","url":"https://{yuva_host}/mcp"}}}{"mcpServers":{"productdevbook-yuva":{"serverUrl":"https://{yuva_host}/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Yuva 是一款面向运营多个产品的团队的开源客户消息工具。来自每个产品的客服邮件、实时聊天、应用内消息和反馈都会汇集到同一个共享收件箱，与从同一处发送和发布的新闻简报、帮助中心、状态页面和分析数据并列呈现。
你可以自行托管：只需一个 Docker 镜像和 Postgres。
警告
Beta。 1.0 发布前，API 仍可能变更，因此请在升级前阅读发布说明。数据库迁移会在服务启动时运行：请先备份。代码尚未经过独立的安全审计。
功能
| 会话 | 每个产品都有独立收件箱，拥有自己的品牌、语言、营业时间和团队。电子邮件、实时聊天、应用内消息和应用反馈都集中在同一会话中，并支持备注、标签、提及，以及由成员审核的机器人草稿。 |
| 团队邮件 | 共享地址（如 sales@）和每个人自己的邮箱位于同一收件箱中，支持草稿、定时发送、筛选和搜索运算符。个人邮箱是私有的，也可以委派他人管理。Yuva 就是邮箱；它不是供邮件应用使用的 IMAP 服务。 |
| 触达 | 带有同意记录的邮件列表和导入、来自模板的电子邮件设计、支持审批和报告的群发，以及送达能力检查。 |
| 发布 | 帮助中心、文档页面、可使用自有域名的状态页面、路线图看板和新功能。 |
| 洞察 | 关于已开启和已关闭会话、响应时间、SLA 和评分的报告、面向网站和应用的无 Cookie 分析，以及根据页面引发的会话数量对页面进行排名的支持报告。 |
| 迁入 | 从 Gmail、Microsoft 365、Yandex、iCloud、Zoho、任何 IMAP 服务、Zendesk、Help Scout 和 Front 迁移历史记录和实时邮件。旧邮箱只会被读取。 |
| 基于它构建 | 带有受限权限密钥的 REST API、签名的 webhook、身份令牌、无头模式，以及支持 Claude、Cursor、VS Code 和其他助手通过 OAuth 使用的 MCP 服务。 |
使用 Go、Postgres 和 React 面板构建，并以单个 Docker 镜像交付。
|
|
| |
快速开始
-
按照安装指南编写
compose.yaml和.env。 -
启动：
docker compose up -d -
创建首位所有者：
docker compose exec yuva /yuva bootstrap --email [email protected] --workspace "Example" -
将其置于 HTTPS 后方，并使用通过电子邮件收到的代码登录。
在 Kubernetes 上，安装 Helm chart oci://ghcr.io/productdevbook/charts/yuva；请参阅
使用 Helm 部署到 Kubernetes。
SDK 和客户端
| 用途 | 安装 | 指南 |
|---|---|---|
Web：<yuva-chat>、无头客户端 | npm install useyuva | Web 小组件、无头客户端 |
| React 和 shadcn/ui | npx shadcn@latest add https://useyuva.com/r/yuva-discussions.json | shadcn 注册表 |
| iOS 和 macOS | Swift package https://github.com/productdevbook/yuva.git，产品 YuvaKit | 移动 SDK |
| Android | implementation("com.github.productdevbook:yuva:v0.3.1") | 移动 SDK |
| Go | go get github.com/productdevbook/yuva/sdk/go | Go SDK |
| AI 助手 | 在你的服务上使用 /mcp，或使用发布版本中的 yuva.mcpb | MCP |
可运行的项目见 examples。
隐私与安全
- 由你托管：对话、联系人和文件都保留在你的服务上。
- 分析功能不设置 Cookie，也不保留跨站标识符；请参阅 分析隐私。
- 每项订阅都会记录同意者、时间和地点，导出列表也会包含此记录。
- 对于助手，客户文本会标记为不可信数据；除非你允许发送，否则回复都只是草稿。
- 请按照 SECURITY.md 中的说明，私下报告漏洞。
文档
指南、API 参考和示例位于 useyuva.com/docs，也可在 docs/ 中查看（另有土耳其语和德语版本）。了解构建方式： 架构。了解后续计划：路线图。了解变更： GitHub Releases。
社区与贡献
请先阅读 CONTRIBUTING.md；贡献须遵守 CLA。
若要启动本地服务（使用 Postgres 和 Mailpit，后者会捕获服务发送的所有邮件），请运行
docker compose -f deploy/compose.yaml up -d。
请在 issues 中提问和报告 Bug，并关注
@useyuva 获取动态。
许可证
服务端和管理面板采用 AGPL-3.0 许可证。SDK（sdk/）和 API 契约（openapi/）
采用 MIT 许可证，因此你可以将其用于闭源应用。详情请见
LICENSING.md；名称和徽标请见 TRADEMARK.md。
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。