Python不要？Mastra と Vercel AI SDK で本番向け TypeScript エージェントを構築

Mastra と Vercel AI SDK で TypeScript 本番エージェントを構築します。公式：Mastra、AI SDK。関連：OpenClaw + Ollama、Mac なし iOS、LLM メモリ、Hermes + Ollama。東京ノードのクラウド Mac でも Node 20+ のみで同手順です。

開示：VpsGona は任意の Mac レンタルを提供。独立プロジェクトです。

TypeScript エージェントの理由

Next.js と同一ランタイム。Studio は localhost:4111、ToolLoopAgent は既定 20 ステップまで—stepCountIs(N) を必ず設定してください。

Python 比較

構成

Mastra: npm create mastra@latest。AI SDK: ToolLoopAgent + createAgentUIStreamResponse。

Mastra 手順（8 ステップ）

1. Node 20+
2. npm create mastra@latest my-ts-agent
3. ウィザード完了
4. src/mastra/ 確認
5. .env
6. npm run dev（:4111）
7. Zod ツール追加
8. 本番デプロイ

AI SDK（6 ステップ）

1. Next.js 15
2. npm install ai @ai-sdk/openai zod
3. ToolLoopAgent
4. Route Handler
5. useChat
6. レート制限・needsApproval

選び方

新規は Mastra、既存 SaaS は AI SDK。iOS は ガイド 参照。

トラブル

ループ過多

stepCountIs を下げる。

Studio 起動失敗

Node 20+ とポート 4111。

FAQ

Do I need Python for Mastra or Vercel AI SDK?

No for the app layer—both run on Node.js 20+. Python may remain for offline ML only.

What Node version is required?

Mastra targets Node 20+. Match dev and CI.

What is the default ToolLoopAgent step limit?

Up to 20 steps unless you set stopWhen: stepCountIs(N).

Where does Mastra Studio run?

Typically http://localhost:4111 after npm run dev.

Can I use local Ollama?

Yes via OpenAI-compatible endpoints; see our OpenClaw + Ollama and Hermes guides for local stacks.