Mastra

Mastra

Mastra는 최신 TypeScript 스택으로 AI 기반 애플리케이션과 에이전트를 구축하기 위한 프레임워크입니다.

초기 프로토타입부터 프로덕션 준비가 완료된 애플리케이션까지 나아가는 데 필요한 모든 것을 포함합니다. Mastra는 React, Next.js, Node 같은 프론트엔드 및 백엔드 프레임워크와 통합되며, 독립형 서버로 어디에나 배포할 수도 있습니다. 신뢰할 수 있는 AI 제품을 구축하고, 튜닝하고, 확장하는 가장 쉬운 방법입니다.

Mastra를 선택하는 이유
TypeScript를 위해 목적에 맞게 설계되었고 검증된 AI 패턴을 기반으로 설계된 Mastra는 훌륭한 AI 애플리케이션을 구축하는 데 필요한 모든 것을 기본으로 제공합니다.

주요 특징은 다음과 같습니다.

모델 라우팅 : 하나의 표준 인터페이스를 통해 40개 이상의 제공자에 연결합니다. OpenAI, Anthropic, Gemini 등의 모델을 사용할 수 있습니다.

에이전트 : LLM과 도구를 사용해 개방형 작업을 해결하는 자율 에이전트를 구축합니다. 에이전트는 목표에 대해 추론하고, 어떤 도구를 사용할지 결정하며, 모델이 최종 답변을 내놓거나 선택적 중지 조건이 충족될 때까지 내부적으로 반복합니다.

워크플로 : 실행에 대한 명시적 제어가 필요할 때는 Mastra의 그래프 기반 워크플로 엔진을 사용해 복잡한 다단계 프로세스를 오케스트레이션합니다. Mastra 워크플로는 제어 흐름을 위한 직관적인 문법( .then() , .branch() , .parallel() )을 사용합니다.

휴먼 인 더 루프 : 에이전트나 워크플로를 일시 중단하고 재개하기 전에 사용자 입력이나 승인을 기다립니다. Mastra는 스토리지를 사용해 실행 상태를 기억하므로 무기한 일시 중지하고 중단한 지점에서 재개할 수 있습니다.

컨텍스트 관리 : 에이전트에게 적시에 적절한 컨텍스트를 제공합니다. 대화 기록 을 제공하고, 소스(API, 데이터베이스, 파일)에서 데이터를 검색하며, Observational Memory로 인간과 유사한 메모리를 추가해 에이전트가 일관되게 동작하도록 합니다.

통합 : 에이전트와 워크플로를 기존 React, Next.js, Node.js 앱에 번들로 포함하거나 독립형 엔드포인트로 배포합니다. UI를 구축할 때는 Vercel의 AI SDK UI, CopilotKit 같은 에이전트 라이브러리와 통합해 AI 어시스턴트를 웹에서 구현할 수 있습니다.

MCP 서버 : Model Context Protocol 서버를 작성해 에이전트, 도구 및 기타 구조화된 리소스를 MCP 인터페이스를 통해 노출합니다. 이는 이후 프로토콜을 지원하는 모든 시스템이나 에이전트에서 접근할 수 있습니다.

프로덕션 필수 요소 : 신뢰할 수 있는 에이전트를 배포하려면 지속적인 통찰, 평가, 반복이 필요합니다. 내장된 평가 와 관측성 을 통해 Mastra는 지속적으로 관찰하고, 측정하고, 개선할 수 있는 도구를 제공합니다.

시작하기
Mastra를 시작하는 권장 방법은 아래 명령을 실행하는 것입니다:

npm create mastra@latest
CLI 또는 수동 설치를 통한 단계별 설정은 설치 가이드 를 참고하세요.

AI 에이전트가 처음이라면 템플릿 , 강좌 , YouTube 영상을 확인하고 오늘부터 Mastra로 구축을 시작하세요.

대안: 미리 만들어진 프롬프트로 시작하기
새 Mastra 프로젝트를 생성하세요. Mastra는 최신 TypeScript 스택에서 AI 애플리케이션과 에이전트를 위한 프레임워크입니다. 명령을 실행하기 전에 다음 질문을 하나씩 하고, 이미 제공되지 않은 경우 각 답변을 기다리세요:

1 . 프로젝트 이름? (기본값: "my-mastra-app")
2 . 제공자? (필수; 옵션: "openai", "anthropic", "google", "xai")

제공자가 지원되지 않으면 다시 질문하고 지원되는 값을 나열하세요.

실행: ` npm create mastra@latest <project-name> -- --llm <provider> `

이 명령은 기본 Mastra 프로젝트를 생성하고, 감지된 코딩 어시스턴트용 Mastra 스킬을 설치하며, 적절한 경우 Git을 초기화합니다.

생성 후 프로젝트 디렉터리로 이동해 개발 서버를 시작하세요: ` npx bgproc start -n <project-name> -w -- npm run dev `

` http://localhost:4111 ` 에서 Mastra Studio를 여세요. Studio는 에이전트, 워크플로, 도구를 구축하고 테스트하고 관리하는 인터페이스입니다.

또한 Mastra 모델 라우터가 수천 개의 모델에 대한 접근을 제공한다는 점을 언급하세요: https://mastra.ai/models

문서
공식 문서 를 방문하세요.

AI로 구축하기
Build with AI 가이드 를 따라 에이전트를 Mastra 전문가로 만드는 방법을 알아보세요.

기여
기여하고 싶으신가요? 풀 리퀘스트는 협력자로 제한됩니다. 따라서 좋은 재현과 설명이 포함된 고품질 이슈를 생성하는 것이 가장 도움이 됩니다. 그러면 Mastra가 보고서를 검증하고 그에 따라 우선순위를 정합니다.

Mastra 또는 그 테스트를 로컬에서 실행하려면 개발 문서 를 참고하세요.

지원
공개 커뮤니티 Discord 가 있습니다. 인사하러 오시고 질문이 있거나 실행에 도움이 필요하면 알려주세요.

페이지 상단에서 프로젝트에 별을 남겨주시면 큰 도움이 됩니다.

라이선스
이 저장소는 이중 라이선스 모델을 사용합니다:

Apache License 2.0 : 핵심 프레임워크와 이 코드베이스의 대부분은 Apache-2.0에 따라 오픈 소스입니다.
Mastra Enterprise License : ee/ 라는 이름의 디렉터리(예: packages/core/src/auth/ee/ )에 있는 코드는 Mastra Enterprise License에 따라 소스 공개(source-available)됩니다. 이러한 기능은 프로덕션 사용을 위해 유효한 엔터프라이즈 라이선스가 필요하지만 개발 및 테스트에는 자유롭게 사용할 수 있습니다.

전체 라이선스 매핑은 LICENSE.md 를, 엔터프라이즈 라이선스 조건은 ee/LICENSE 를 참고하세요.

보안
우리는 이 저장소와 Mastra 전체의 보안을 유지하는 데 전념하고 있습니다. 보안 문제를 발견하면 [email protected] 로 책임 있게 알려주시기 바라며, 저희가 회신드리겠습니다.