Mastra

Name: Mastra
Author: mastra-ai

本地服务

github.com/mastra-ai开发工具29.2k今天更新

代码仓库

关于 Mastra

Mastra 是面向开发者的 TypeScript 框架，用于构建 AI 应用和 Agent，并将原型推进到生产环境。它结合了 Agent 与工作流编排、模型路由、上下文管理及 MCP 服务开发能力。

主要功能

01路由 40 多家提供商的模型
02构建可调用工具的 Agent
03编排图式工作流
04暂停以等待人工输入或批准
05管理上下文与记忆
06提供内置评估与可观测性

适用场景

01构建 TypeScript AI 应用原型
02协调多步骤 Agent 流程
03等待用户批准后恢复工作流
04通过 MCP 暴露 Agent 和工具

MCP 相关

Mastra 可用于开发 MCP 服务，向兼容客户端暴露 Agent、工具和结构化资源。

#mastra #ai-framework #typescript

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "mastra": {
      "command": "npx",
      "args": [
        "-y",
        "@mastra/mcp-docs-server"
      ]
    }
  }
}

启动命令npx -y @mastra/mcp-docs-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@mastra/mcp-docs-serverstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
paths	array	是	要获取的一个或多个文档路径可用路径：可用的顶层路径：目录： - course/ - docs/ - integrations/ - models/ - reference/ Reference 子目录： - reference/acp/ - reference/agent-controller/ - reference/agents/ - reference/ai-sdk/ - reference/auth/ - reference/browser/ - reference/channels/ - reference/cli/ - reference/client-js/ - reference/code-sdk/ - reference/coding-agent/ - reference/core/ - reference/datasets/ - reference/deployer/ - reference/editor/ - reference/evals/ - reference/file-based-agents/ - reference/logging/ - reference/memory/ - reference/migrations/ - reference/observability/ - reference/processors/ - reference/pubsub/ - reference/rag/ - reference/schedules/ - reference/server/ - reference/signals/ - reference/storage/ - reference/streaming/ - reference/templates/ - reference/tools/ - reference/vectors/ - reference/voice/ - reference/workers/ - reference/workflows/ - reference/workspace/ 文件： - integrations
queryKeywords	array	否	用于匹配文档的用户查询关键词。每个关键词应为单个词或简短短语；系统会自动拆分包含空格的关键词。

详细介绍

Mastra

Mastra 是一个使用现代 TypeScript 技术栈构建 AI 应用和 Agent 的框架。

它包含了从早期原型到可投入生产的应用所需的一切。Mastra 可与 React、Next.js 和 Node 等前端及后端框架集成，也可以作为独立服务部署到任何地方。它是构建、调优和扩展可靠 AI 产品的最简单方式。

为什么选择 Mastra？

Mastra 专为 TypeScript 打造，并围绕成熟的 AI 模式设计，开箱即用，为你提供构建出色 AI 应用所需的一切。

亮点包括：

模型路由：通过一个标准接口连接 40 多家提供商。使用 OpenAI、Anthropic、Gemini 等提供的模型。
Agent：构建使用大模型和工具解决开放式任务的自主 Agent。Agent 会围绕目标进行推理、决定使用哪些工具，并在内部迭代，直到模型输出最终答案或满足可选的停止条件。
工作流：当你需要明确控制执行过程时，可使用 Mastra 基于图的工作流引擎来编排复杂的多步骤流程。Mastra 工作流采用直观的控制流语法（.then()、.branch()、.parallel()）。
人工参与环节：暂停 Agent 或工作流，并等待用户输入或批准后再继续。Mastra 使用存储记住执行状态，因此你可以无限期暂停，并从上次停下的位置继续。
上下文管理：在恰当的时机为 Agent 提供合适的上下文。提供对话历史，从你的数据源（API、数据库、文件）检索数据，并通过观察式记忆添加类似人类的记忆，让 Agent 的行为保持连贯。
集成：将 Agent 和工作流集成到现有的 React、Next.js 或 Node.js 应用中，或将它们作为独立端点发布。构建 UI 时，可集成 Vercel 的 AI SDK UI 和 CopilotKit 等 Agent 框架库，让 AI 助手在 Web 上焕发生机。
MCP 服务：编写 Model Context Protocol 服务，通过 MCP 接口公开 Agent、工具和其他结构化资源。随后，任何支持该协议的系统或 Agent 都可以访问这些资源。
生产环境必备：交付可靠的 Agent 需要持续洞察、评估和迭代。借助内置的评估和可观测性，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:

1. Project name? (default: "my-mastra-app")
2. 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

文档

访问我们的官方文档。

使用 AI 构建

按照使用 AI 构建指南，了解如何让你的 Agent 成为 Mastra 专家。

贡献

想要参与贡献？拉取请求仅限协作者提交。因此，_最好的_帮助方式是创建高质量的问题，并提供良好的复现步骤和描述。Mastra 随后会核实你的报告并据此确定优先级。

如果你想在本地运行 Mastra 或其测试，请参阅开发文档

支持

我们有一个开放的社区 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。