Mastra：TypeScript AI 应用与 Agent 开发框架

Mastra 是一个基于 TypeScript 的 AI 应用开发框架，目前在 GitHub 上收获了 24,972 个 Star，同时是 YC W25 批次成员项目。它提供了从原型验证到生产部署的完整工具链，覆盖模型接入、Agent 构建、工作流编排等核心能力。

为什么选 Mastra

AI 框架的选型往往取决于团队的技术栈。Mastra 完全围绕 TypeScript 设计，对于已经在用 React、Next.js 或 Node.js 的团队来说，不需要引入额外的语言或运行时。框架可以嵌入现有的前后端应用，也可以作为独立服务器部署，接入方式灵活。

模型路由

Mastra 通过一个统一接口接入 40 多个模型提供商，包括 OpenAI、Anthropic、Gemini 等。业务代码面向 Mastra 的接口编写，切换底层模型时只改配置，不动业务逻辑。在需要对比不同模型效果的阶段，这种解耦方式能省不少工作。

Agent 构建

Mastra 支持构建具备自主推理能力的 AI Agent。Agent 接收目标后，会自行判断需要调用哪些工具、规划执行步骤，然后在内部反复迭代，直到输出最终结果或满足停止条件。

上下文管理方面，Mastra 提供了对话历史、数据检索（RAG）、工作记忆和语义记忆四个模块。这些机制让 Agent 在多轮交互中保持上下文连贯，不会每次都从零开始处理请求。

工作流引擎

当任务流程需要精确控制时，可以使用 Mastra 的图结构工作流引擎。.then() 串行、.branch() 条件分支、.parallel() 并行，语法简洁直观。

工作流还支持 Human in the loop 模式，在任意节点挂起等待用户输入或审批。执行状态持久化到存储层，暂停再久都能从断点恢复，适合需要人工审核的业务场景。

MCP Server 支持

Mastra 可以生成 Model Context Protocol 服务器，将 Agent、工具等资源通过 MCP 协议暴露给外部系统。任何支持该协议的客户端都能调用这些资源，为跨系统协作提供了标准化接口。

前端集成

在 UI 层面，Mastra 能与 Vercel AI SDK UI、CopilotKit 等 agentic 库配合，将 AI 助手能力接入 Web 界面。前后端使用同一套框架，省去了跨技术栈桥接的工作。

生产就绪

框架内置了评测（evals）和可观测性（observability）两个模块。评测用于衡量 Agent 的输出质量，可观测性提供行为监控和链路追踪。从 demo 到生产环境，这两个能力缺一不可。

快速开始

一条命令初始化项目：

npm create mastra@latest

跟着安装向导完成配置即可。官方还提供了模板库、教程课程和 YouTube 视频，上手门槛不高。

Mastra 采用 Apache 2.0 双重许可，核心框架完全开源，部分企业功能需要单独授权。

Mastra 采用 Apache 2.0 双重许可，核心框架完全开源，部分企业功能需要单独授权。