dotsagent.io
언어:한국어
프레임워크 · 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 · 별 28,467개
호스팅 옵션
Mastra Cloud / Mastra Platform
mastra deploy 명령은 Docker 이미지를 빌드하고 배포합니다.

Quickstart

패키지를 설치하고 인증 정보를 설정한 다음, 공식 문서에서 가장 간단한 에이전트를 실행하세요. 모델 ID는 문서에서 사용하는 값이며 계정에서 활성화되지 않았을 수 있습니다.

설치
npm install @mastra/core@latest zod@latest typescript@latest @types/node@latest mastra@latest  (or scaffold: npm create mastra@latest)

OPENAI_API_KEY 필요

TypeScript
// 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)

Quickstart 출처

기능

모든 모델예provider/model 형식의 모델 라우터 문자열
MCP 클라이언트예
MCP 서버예MCPServer로 에이전트, 도구, 워크플로, 프롬프트, 리소스를 노출합니다
멀티 에이전트예에이전트가 다른 에이전트의 도구로 동작할 수 있습니다
내구성 있는 실행예libSQL, Postgres 등에서 스냅샷을 사용해 일시 중지 및 재개할 수 있습니다
사람의 승인예suspend()와 resume()으로 사람의 입력을 받습니다
트레이싱예Langfuse, Braintrust, Datadog, LangSmith용 OTel exporter를 지원합니다
Evals예샘플링을 사용해 실행 중에 scorer를 적용하거나 CI에서 오프라인으로 실행할 수 있습니다

최근 변경 사항

  • npm create mastra를 실행하면 워크스페이스, 셸 도구, 메모리, 스케줄을 갖춘 범용 하네스가 생성됩니다.
  • Mastra Factory는 코딩 에이전트로 구성된 소프트웨어 팩토리를 대상으로 합니다.

같은 언어로 만든 대안

출처

  1. mastra.ai/docs
  2. mastra.ai/docs/connections/mcp
  3. mastra.ai/reference/tools/mcp-server
  4. mastra.ai/docs/workflows/suspend-and-resume
  5. mastra.ai/docs/workflows/snapshots
  6. mastra.ai/ai-agent-observability
  7. github.com/mastra-ai/mastra/blob/main/LICENSE.md
  8. registry.npmjs.org/@mastra%2fcore