开源 JavaScript Agent 框架,由 Gatsby 开发者构建,为 JS 生态提供低门槛的 Agent 开发工具链。
Mastra 是一个使用现代 TypeScript 技术栈构建 AI 驱动的应用和 Agent 的框架。
从早期原型到可投入生产的应用,它提供了你需要的一切。Mastra 可以集成 React、Next.js 和 Node 等前端与后端框架,也可以作为独立服务器部署到任何地方。它是构建、调优和扩展可靠 AI 产品最简单的方式。
Mastra 专为 TypeScript 打造,并围绕成熟的 AI 模式设计,让你开箱即用地获得构建优秀 AI 应用所需的一切。
其中一些亮点包括:
模型路由——通过一个标准接口连接 40 多家提供商。可以使用 OpenAI、Anthropic、Gemini 等平台的模型。
模型路由——通过一个标准接口连接 40 多家提供商。可以使用 OpenAI、Anthropic、Gemini 等平台的模型。
Agent——构建使用 LLM 和工具解决开放式任务的自主 Agent。Agent 会围绕目标进行推理,决定使用哪些工具,并在内部反复迭代,直到模型给出最终答案,或满足可选的停止条件。
Agent——构建使用 LLM 和工具解决开放式任务的自主 Agent。Agent 会围绕目标进行推理,决定使用哪些工具,并在内部反复迭代,直到模型给出最终答案,或满足可选的停止条件。
工作流——需要明确控制执行过程时,可以使用 Mastra 基于图的工作流引擎编排复杂的多步骤流程。Mastra 工作流使用直观的控制流语法(.then()、.branch()、.parallel())。
工作流——需要明确控制执行过程时,可以使用 Mastra 基于图的工作流引擎编排复杂的多步骤流程。Mastra 工作流使用直观的控制流语法(.then()、.branch()、.parallel())。
人在回路——暂停 Agent 或工作流,等待用户输入或批准后再恢复执行。Mastra 使用存储来记住执行状态,因此你可以无限期暂停,并从中断的位置继续执行。
人在回路——暂停 Agent 或工作流,等待用户输入或批准后再恢复执行。Mastra 使用存储来记住执行状态,因此你可以无限期暂停,并从中断的位置继续执行。
上下文管理——在正确的时间为 Agent 提供正确的上下文。你可以提供对话历史,从自己的数据源(API、数据库、文件)中检索数据,还可以通过 Observational Memory 添加类似人类的记忆,让 Agent 的行为保持连贯。
上下文管理——在正确的时间为 Agent 提供正确的上下文。你可以提供对话历史,从自己的数据源(API、数据库、文件)中检索数据,还可以通过 Observational Memory 添加类似人类的记忆,让 Agent 的行为保持连贯。
集成——将 Agent 和工作流整合到现有的 React、Next.js 或 Node.js 应用中,或将其作为独立端点发布。构建 UI 时,可以集成 Vercel AI SDK UI 和 CopilotKit 等 Agentic 库,让你的 AI 助手在 Web 上真正运转起来。
集成——将 Agent 和工作流整合到现有的 React、Next.js 或 Node.js 应用中,或将其作为独立端点发布。构建 UI 时,可以集成 Vercel AI SDK UI 和 CopilotKit 等 Agentic 库,让你的 AI 助手在 Web 上真正运转起来。
MCP 服务器——编写 Model Context Protocol 服务器,通过 MCP 接口公开 Agent、工具及其他结构化资源。之后,任何支持该协议的系统或 Agent 都可以访问这些资源。
MCP 服务器——编写 Model Context Protocol 服务器,通过 MCP 接口公开 Agent、工具及其他结构化资源。之后,任何支持该协议的系统或 Agent 都可以访问这些资源。
生产必备能力——交付可靠的 Agent,需要持续获取洞察、开展评估并反复迭代。借助内置的 evals 和可观测性能力,Mastra 为你提供持续观察、衡量和改进所需的工具。
生产必备能力——交付可靠的 Agent,需要持续获取洞察、开展评估并反复迭代。借助内置的 evals 和可观测性能力,Mastra 为你提供持续观察、衡量和改进所需的工具。
推荐通过运行以下命令开始使用 Mastra:
npm create mastra@latest
按照安装指南操作,通过 CLI 或手动安装完成逐步配置。
如果你刚接触 AI Agent,可以查看我们的模板、课程和 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:
Project name? (default: "my-mastra-app")
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
请访问我们的官方文档。
按照 Build with AI 指南操作,了解如何让你的 Agent 成为 Mastra 专家。
想参与贡献?无论是编写代码、测试还是功能规划,各种形式的帮助都备受欢迎。有关参与方式的更多详情,请阅读 CONTRIBUTING.md。
如果你是开发者,并希望贡献代码,请在提交 Pull Request 之前先创建 issue 进行讨论。
有关项目配置的信息,可以在开发文档中找到。
我们有一个开放的社区 Discord。欢迎前来打招呼;如果你有任何问题,或者需要协助完成环境配置,也请告诉我们。
如果你能在本页面顶部为项目点一颗 star,也会给我们带来很大帮助。
本仓库采用双许可证模式:
Apache License 2.0——核心框架以及此代码库的绝大部分内容,均以 Apache-2.0 许可证开源。
Mastra Enterprise License——所有名为 ee/ 的目录(例如 packages/core/src/auth/ee/)中的代码,均依据 Mastra Enterprise License 以源码可用的形式发布。这些功能在生产环境中使用时需要有效的企业许可证,但可以免费用于开发和测试。
完整的许可证对应关系请参阅 LICENSE.md,企业许可证条款请参阅 ee/LICENSE。
我们致力于维护此仓库以及整个 Mastra 的安全。如果你发现任何安全问题,请通过 security@mastra.ai 负责任地向我们披露,我们会及时回复。