프레임워크 · Mastra
Mastra 한눈에 보기
에이전트, 일시 중지 및 재개를 지원하는 워크플로, 메모리, 평가 기능과 Studio UI를 하나의 패키지에 담은 TypeScript 프레임워크입니다. Next.js, Express 또는 Hono 앱에 통합할 수 있습니다. 핵심 코드는 Apache-2.0 라이선스이며 ee/ 디렉터리에는 엔터프라이즈 라이선스가 적용됩니다.
추천 용도: 에이전트, 워크플로, 메모리, 평가를 위한 단일 스택을 원하는 TypeScript 팀
주요 정보
- 관리자
- Mastra
- 언어
- TypeScript
- 라이선스
- Apache-2.0 (core)
- 최신 버전
@mastra/core 1.73.0· 2026년 10월 1일- 저장소
- mastra-ai/mastra
- 호스팅 옵션
- Mastra Cloud / Mastra Platform
Quickstart
패키지를 설치하고 인증 정보를 설정한 다음, 공식 문서에서 가장 간단한 에이전트를 실행하세요. 모델 ID는 문서에서 사용하는 값이며 계정에서 활성화되지 않았을 수 있습니다.
npm install @mastra/core@latest zod@latest typescript@latest @types/node@latest mastra@latest (or scaffold: npm create mastra@latest)// src/mastra/agents/weather-agent.ts
import { Agent } from '@mastra/core/agent'
import { weatherTool } from '../tools/weather-tool.ts'
export const weatherAgent = new Agent({
id: 'weather-agent',
name: 'Weather Agent',
instructions: `
You are a helpful weather assistant that provides accurate weather information.
Your primary function is to help users get weather details for specific locations. When responding:
- Include relevant details like humidity, wind conditions, and precipitation
- Keep responses concise but informative
Use the weatherTool to fetch current weather data.
`,
// Use a string in provider/model format, not provider:model or a provider object.
model: 'openai/gpt-5.6-sol',
tools: { weatherTool },
})
// run.mjs (after registering the agent in src/mastra/index.ts)
import { mastra } from './src/mastra/index.ts'
const agent = mastra.getAgentById('weather-agent')
const response = await agent.generate('Weather in SF')
console.log(response.text)기능
| 모든 모델 | 예 | provider/model 형식의 모델 라우터 문자열 |
|---|---|---|
| MCP 클라이언트 | 예 | |
| MCP 서버 | 예 | MCPServer로 에이전트, 도구, 워크플로, 프롬프트, 리소스를 노출합니다 |
| 멀티 에이전트 | 예 | 에이전트가 다른 에이전트의 도구로 동작할 수 있습니다 |
| 내구성 있는 실행 | 예 | libSQL, Postgres 등에서 스냅샷을 사용해 일시 중지 및 재개할 수 있습니다 |
| 사람의 승인 | 예 | suspend()와 resume()으로 사람의 입력을 받습니다 |
| 트레이싱 | 예 | Langfuse, Braintrust, Datadog, LangSmith용 OTel exporter를 지원합니다 |
| Evals | 예 | 샘플링을 사용해 실행 중에 scorer를 적용하거나 CI에서 오프라인으로 실행할 수 있습니다 |
최근 변경 사항
- npm create mastra를 실행하면 워크스페이스, 셸 도구, 메모리, 스케줄을 갖춘 범용 하네스가 생성됩니다.
- Mastra Factory는 코딩 에이전트로 구성된 소프트웨어 팩토리를 대상으로 합니다.