Mastra

Mastra

Mastraは、最新のTypeScriptスタックを使用して、AIを活用したアプリケーションやエージェントを構築するためのフレームワークです。

初期のプロトタイプから本番環境に対応したアプリケーションまで、開発に必要なものがすべて含まれています。MastraはReact、Next.js、Nodeなどのフロントエンドおよびバックエンドフレームワークと統合できるほか、スタンドアロンサーバーとして任意の場所にデプロイすることもできます。信頼性の高いAI製品を構築、調整、拡張するための最も簡単な方法です。

Mastraを選ぶ理由

TypeScript向けに特化して構築され、確立されたAIパターンを中心に設計されたMastraには、優れたAIアプリケーションをすぐに構築するために必要なものがすべて揃っています。

主な機能は次のとおりです。

• モデルルーティング：単一の標準インターフェースを通じて、40以上のプロバイダーに接続できます。OpenAI、Anthropic、Geminiなどのモデルを使用できます。

• エージェント：LLMとツールを使用して、自由度の高いタスクを解決する自律型エージェントを構築できます。エージェントは目標について推論し、使用するツールを決定して、モデルが最終回答を出力するか、任意の停止条件が満たされるまで内部で反復します。

• ワークフロー：実行を明示的に制御する必要がある場合は、Mastraのグラフベースのワークフローエンジンを使って、複雑な複数ステップのプロセスを調整できます。Mastraのワークフローでは、制御フローに直感的な構文（.then()、.branch()、.parallel()）を使用します。

• Human-in-the-loop：エージェントまたはワークフローを一時停止し、再開前にユーザーの入力や承認を待つことができます。Mastraは実行状態を記憶するためにストレージを使用するため、無期限に一時停止し、中断したところから再開できます。

• コンテキスト管理：適切なタイミングで、エージェントに適切なコンテキストを提供できます。会話履歴を渡し、データソース（API、データベース、ファイル）からデータを取得し、Observational Memoryで人間のような記憶を加えることで、エージェントが一貫性のある動作をするようにできます。

• 統合：エージェントやワークフローを既存のReact、Next.js、Node.jsアプリに組み込んだり、スタンドアロンのエンドポイントとして公開したりできます。UIの構築時には、VercelのAI SDK UIやCopilotKitなどのエージェント向けライブラリと統合して、ウェブ上でAIアシスタントを実現できます。

• MCP サーバー：Model Context Protocolサーバーを作成し、MCPインターフェースを通じてエージェント、ツール、その他の構造化されたリソースを公開できます。これらは、プロトコルをサポートするあらゆるシステムやエージェントから利用できます。

• 本番運用に不可欠な機能：信頼性の高いエージェントを提供するには、継続的な把握、評価、反復が必要です。組み込みの評価とオブザーバビリティにより、継続的な観察、測定、改善に必要なツールを利用できます。

はじめに

Mastra を使い始めるおすすめの方法は、以下のコマンドを実行することです。

npm create mastra@latest

CLI を使った手順に沿ったセットアップ、または手動インストールについては、インストールガイドをご覧ください。

AI エージェントを初めて使う方は、テンプレート、コース、YouTube 動画を参考にして、今日から Mastra での構築を始めましょう。

Create a new Mastra project. Mastra is a framework for AI applications and agents on a modern TypeScript stack. Before running the command, ask these questions one at a time and wait for each answer unless it was already provided:

1. Project name? (default: "my-mastra-app")
2. Provider? (required; options: "openai", "anthropic", "google", "xai")

If the provider isn't supported, ask again and list the supported values.

Run: `npm create mastra@latest <project-name> -- --llm <provider>`

The command creates a default Mastra project, installs Mastra skills for detected coding assistants, and initializes Git when appropriate.

After creation, enter the project directory and start the dev server: `npx bgproc start -n <project-name> -w -- npm run dev`

Open Mastra Studio at `http://localhost:4111`. Studio is the interface for building, testing, and managing agents, workflows, and tools.

Also mention that the Mastra model router provides access to thousands of models: https://mastra.ai/models

ドキュメント

公式ドキュメントをご覧ください。

AI を使って構築する

AI を使った構築ガイドに沿って、エージェントを Mastra のエキスパートにする方法を学びましょう。

コントリビューション

コントリビューションをご希望ですか？プルリクエストはコラボレーターのみに制限されています。そのため、再現手順と説明を添えた質の高い課題を作成していただくのが、最も効果的な支援になります。Mastra が報告内容を確認し、優先度を決定します。

Mastra やそのテストをローカルで実行する場合は、開発ドキュメントをご覧ください。

サポート

オープンなコミュニティ Discordがあります。ぜひ参加して、気軽に声をかけてください。質問がある場合や、実行環境のセットアップでお困りの場合はお知らせください。

このページの上部で、プロジェクトにスターを付けていただけると大変助かります。

ライセンス

このリポジトリでは、デュアルライセンスモデルを採用しています。

• Apache License 2.0：コアフレームワークとコードベースの大部分は、Apache-2.0 のオープンソースとして公開されています。
• Mastra Enterprise License：ee/ という名前のディレクトリ内のコード（例：packages/core/src/auth/ee/）は、Mastra Enterprise License に基づきソースを利用できます。これらの機能を本番環境で使用するには有効なエンタープライズライセンスが必要ですが、開発およびテストでは自由に使用できます。

ライセンスの適用範囲全体についてはLICENSE.mdを、エンタープライズライセンスの条件についてはee/LICENSEをご覧ください。

セキュリティ

当リポジトリおよび Mastra 全体のセキュリティ維持に取り組んでいます。セキュリティ上の問題を発見した場合は、[email protected]まで責任を持ってご報告ください。折り返しご連絡いたします。