Samva MCP

Samva

用于将 Samva 集成到实际应用中的开源软件包、示例、实用指南和 Agent 插件。

可使用这些内容发送事务性电子邮件、接入身份验证邮件流程、处理模板、处理投递事件，以及验证已签名的 Webhook。你可以在 DeepWiki 上询问有关代码的问题。

结构

• packages/* — 软件包集成（@samva/*）。
• examples/* — 完整、可运行的示例应用。
• cookbooks/*.md — 以文档为先、可复制粘贴的配方。
• plugins/* — 面向编码 Agent 的插件和公开文档。

Samva 目前处于 0.x 阶段，维护中的集成仅支持当前 SDK 次版本：0.27。工作区软件包要求将 samva@^0.27.0 作为对等依赖，并针对 0.27.0 进行测试。示例使用 samva@^0.27.0；可复制到外部的导入映射固定使用 [email protected]。

软件包集成

• @samva/better-auth — 由 Samva 提供支持的 Better Auth 邮件回调。
• @samva/email-sdk — 由提供方维护的 Email SDK 社区适配器。

Agent 插件

• samva — 为规范托管 MCP 服务和 Samva Agent 技能提供 OpenAI Codex 与 Cursor 打包方案。
• ChatGPT 中的 Samva — 已发布的 ChatGPT 插件与 Codex 和 Cursor 软件包是不同的条目；该指南介绍了如何连接一个组织，以及如何进行首次只读检查。

实用指南

• Astro
• Auth.js
• Better Auth
• Clerk
• Effect SDK
• Email SDK
• Hono on Cloudflare Workers
• 收件邮件回复
• 邮箱
• Next.js
• Prisma
• React Email
• Supabase Auth
• SvelteKit
• TanStack Start
• TSX 模板

集成以单独的拉取请求形式提交。请参阅 CONTRIBUTING.md，了解如何提议或构建集成。

示例

• astro-email — 在 Cloudflare Workers 上运行的 Astro Action 和 JSON 端点。
• better-auth-nextjs — 在 Next.js App Router 应用程序中的 Better Auth 回调。
• clerk-webhook — 在 Next.js 中验证 Clerk webhook 并发送事务性电子邮件。
• effect-sdk — 通过 samva/effect SDK 入口发送电子邮件。
• email-sdk — 通过由服务提供方维护的 Samva 社区适配器使用 Email SDK 发送电子邮件。
• hono-cloudflare-workers — 带有 JSON 电子邮件端点的 Hono Worker。
• inbound-email-replies — 接收一封入站回复，验证签名 webhook，并在线程中回复。
• mailbox-agent — 跟踪邮箱事件流并在审批模式下回复的 Agent；还提供 @samva/mailbox webhook 扩展，实现相同的行为。
• nextjs-transactional — App Router 联系表单，以及使用 Samva SDK 的 /api/send 路由处理程序。
• react-email-samva — 使用 Samva 渲染和发送 React Email。
• supabase-auth-hook — 以 Edge Function 实现的 Supabase Auth Send Email Hook。
• sveltekit-transactional — SvelteKit 表单操作和原始电子邮件端点。
• tanstack-start-transactional — TanStack Start 服务端函数和服务端路由。
• tsx-template-samva — 一个 defineTemplate 电子邮件项目：使用 Samva CLI 进行检查、渲染、预览和发布。

快速开始

这是一个 Bun + Turborepo 单体仓库。

bun install
bun run build
bun run typecheck
bun run test
bun run lint
bun run format:check

相关开源项目

• SML — Samva TSX 模板背后的标记语言、Vite 插件和编辑器。
• DomainKit — Samva 使用 DomainKit 为客户设置域名。请参阅 工作原理。

贡献

欢迎贡献 — 有关本地设置、软件包约定以及如何提议新的集成，请参阅 CONTRIBUTING.md。维护者使用 Tegami 发布流程管理软件包版本、变更日志、npm 发布、标签和 GitHub Releases。发布由 GitHub Actions 执行；合并 Version Packages 拉取请求是人工把关环节。

安全

如需报告漏洞，请参阅 SECURITY.md。请勿公开提交安全问题。

许可证

MIT © Arya Labs, Inc.