mastra-ai/mastra
AI 工程面向 TypeScript 开发者的 AI 应用与 Agent 框架,内置模型路由、工作流、记忆、RAG、评测与可观测性。
项目介绍
Mastra 是一个用 TypeScript 构建 AI 应用与 Agent 的框架,目标用户是希望从原型走到生产服务、但不想自己拼装每一块的团队。它把常用能力收在统一接口下:模型路由可接入 40 多家供应商,Agent 能调用工具完成开放式任务,工作流引擎以 .then()、.branch()、.parallel() 编排多步流程,human-in-the-loop 借助存储暂停执行、等待用户输入或审批后再恢复。上下文方面支持对话历史、从 API/数据库/文件检索数据以及 Agent 记忆;MCP 服务器、评测和可观测性则覆盖对接与生产监控。
它面向 React、Next.js、Node.js 的 TypeScript 开发者,也可以作为独立服务器部署。项目还提供模板、课程等学习材料。
快速使用
推荐从脚手架开始:
npm create mastra@latest
CLI 与手动安装的逐步说明见安装文档。脚手架也支持非交互方式:npm create mastra@latest <project-name> -- --llm <provider>,其中 provider 可选 openai、anthropic、google 或 xai。创建完成后进入项目目录并启动开发服务器,即可在 http://localhost:4111 打开 Mastra Studio,用它构建、测试和管理 Agent、工作流与工具。若要在已有应用中集成,React、Next.js、Node.js 的接入方式另有文档。
使用约束
框架基于 TypeScript,运行环境需支持 React、Next.js、Node.js 或独立服务器部署。human-in-the-loop 工作流和记忆依赖已配置的存储;模型路由需要所选供应商的凭据。许可证为双轨制:核心框架和绝大部分代码采用 Apache-2.0,名为 ee/ 的目录下代码以 Mastra Enterprise License 源码可见,生产使用需要有效的企业许可证,开发与测试可自由使用,完整条款见许可证映射与企业许可证文件。Pull request 仅限协作者提交,外部贡献者被引导去提交高质量 issue。
供应链提醒
2026 年 6 月 Hacker News 上的一则讨论提到,根据 StepSecurity 威胁情报,多个 mastra npm 包遭到入侵,详见该讨论。安装或升级相关包时,应自行核对所装版本与完整性;资料中没有给出后续处置细节,不能据此判断当前状态。
HotRepo 点评
站内记录中,该项目只有 2026-11-17 的 TypeScript 语言日榜快照:29,561 星、3,107 个 fork,当日新增 25 星,在该榜的最好名次为第 12。这只是单日单条记录,只能说明当天上榜,不能据此判断趋势。更有参考价值的是社区反馈:2025 年 2 月的 Show HN 帖获得 442 分和 154 条评论,2026 年 1 月的 1.0 帖获得 213 分和 70 条评论。早期讨论中,有评论者认为工作流构建器的链式写法把图结构表达得别扭,维护者回应称条件逻辑放在各步骤上、不体现在工作流结构中。评估 API 时值得参考这一点:工作流是显式、图导向的,Agent 的自主性属于另一层。2026 年 6 月的包被入侵事件则是采用这些 npm 包前需要了解的运营信息。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。