搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

mastra-ai/mastra

AI 工程

面向 TypeScript 开发者的 AI 应用与 Agent 框架,内置模型路由、工作流、记忆、RAG、评测与可观测性。

29,596
3,114
TypeScript
NOASSERTION
创建于 2 年前

项目介绍

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 生成,更新于 ,以项目官方文档为准。

Hacker News 讨论

Show HN: Mastra – Open-source JS agent framework, by the developers of Gatsby
▲ 442 · 154 条评论 · 2025年2月19日
Show HN: Mastra 1.0, open-source JavaScript agent framework from the Gatsby devs
▲ 213 · 70 条评论 · 2026年1月20日
Show HN: Principles of Building AI Agents book [pdf]
▲ 5 · 0 条评论 · 2025年8月6日

相关推荐

  1. vercel/ai用一套 TypeScript API 调用多家大模型,并把模型接入前端界面和智能体。TypeScript27,500
  2. CopilotKit/CopilotKit把已有 Agent 接入网页、移动端与聊天界面的 SDK,支持生成式 UI 与共享状态。TypeScript38,353
  3. davemessew/AgentFlux可自托管的可视化平台,用来编排大模型工作流和自主智能体,连接本地文件与模型。JavaScript111
  4. osolmaz/switch让分类式决策模型按步骤从有限选项中做选择,直到完成任务的 harness 框架。TypeScript236
  5. docker/docker-agent用 YAML 定义多智能体与工具链,接任意模型,可作为 Docker 插件运行和分发。Go4,609