Samva MCP

Samva

Samva を実際のアプリケーションに統合するためのオープンソースパッケージ、サンプル、クックブック、エージェントプラグインです。

これらを使って、トランザクションメールの送信、認証メールフローの接続、テンプレートの操作、配信イベントの処理、署名付き Webhook の検証を行えます。コードに関する質問は DeepWiki でお尋ねください。

構成

• packages/* — パッケージ統合（@samva/*）。
• examples/* — 完成済みの実行可能なサンプルアプリ。
• cookbooks/*.md — ドキュメントを中心とした、コピーして使えるレシピ。
• plugins/* — コーディングエージェント向けプラグインと公開ドキュメント。

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 向けの、プロバイダー提供の Samva コミュニティアダプター。

エージェントプラグイン

• samva — 正規のホステッド MCP サーバーと Samva エージェントスキルを、OpenAI Codex と Cursor 向けにパッケージ化したもの。
• ChatGPT で Samva を使う — 公開されている ChatGPT プラグインは Codex および Cursor のパッケージとは別の掲載項目です。このガイドでは、1 つの組織への接続と、最初に読み取り専用で確認する方法を説明します。

クックブック

• 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 — メールボックスのイベントストリームを監視して承認モードで返信するエージェントと、同じ動作を実現する @samva/mailbox webhook 拡張機能です。
• nextjs-transactional — Samva SDK を使用する App Router のお問い合わせフォームと /api/send ルートハンドラーです。
• react-email-samva — Samva を通じた React Email のレンダリングと配信です。
• supabase-auth-hook — Edge Function として実装された Supabase Auth Send Email Hook です。
• sveltekit-transactional — SvelteKit のフォームアクションと raw メールエンドポイントです。
• 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をご覧ください。メンテナーは、パッケージのバージョン、変更履歴、npm への公開、タグ、GitHub Releases に Tegami のリリースフローを使用します。公開は GitHub Actions が行い、Version Packages のプルリクエストをマージするのが、人による最終承認です。

セキュリティ

脆弱性の報告方法については、SECURITY.mdをご覧ください。セキュリティに関する報告を公開のイシューとして投稿しないでください。

ライセンス

MIT © Arya Labs, Inc.