---
title: "Mastra: 기능, 버전, Quickstart · DotsAgent"
description: "Mastra의 Mastra: 라이선스, 최신 버전, MCP 지원, 내구성 있는 실행, 사람의 승인, 추적 및 평가 기능을 확인하고 복사해 쓸 수 있는 Quickstart를 살펴보세요."
url: https://dotsagent.io/ko/frameworks/mastra
---

프레임워크 · 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](https://github.com/mastra-ai/mastra) · 별 28,467개
- **호스팅 옵션**: [Mastra Cloud / Mastra Platform](https://mastra.ai/docs)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 출처](https://mastra.ai/docs)

## 기능

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

## 최근 변경 사항

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

## 같은 언어로 만든 대안

- [OpenAI Agents SDK (JS)](https://dotsagent.io/ko/frameworks/openai-agents-js)

- [Claude Agent SDK](https://dotsagent.io/ko/frameworks/claude-agent-sdk)

- [Google ADK](https://dotsagent.io/ko/frameworks/google-adk)

- [LangGraph](https://dotsagent.io/ko/frameworks/langgraph)

- [LlamaIndex](https://dotsagent.io/ko/frameworks/llamaindex)

- [Vercel AI SDK](https://dotsagent.io/ko/frameworks/vercel-ai-sdk)

## 출처

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

AI 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다.

© 2026 DotsAgent · 정보 확인일: 2026년 10월 1일