Mastra MCP 문서 서버

@mastra/mcp-docs-server 는 MCP를 지원하는 Cursor, Windsurf, Cline 등 다양한 IDE에서 Mastra의 전체 지식 베이스에 직접 접근할 수 있게 해주는 도구입니다.

이 도구를 통해 IDE는 Mastra의 공식 문서, 코드 예제, 기술 블로그, 기능 발표, 패키지 변경 이력 등 다양한 자료에 접근할 수 있으며, 개발자가 Mastra를 활용해 에이전트를 개발하거나, 새로운 기능을 추가하거나, 프로젝트를 생성하고, 특정 기능의 동작 방식을 이해하는 데 도움이 됩니다.

MCP 서버 도구들은 에이전트가 Mastra 관련 작업을 완료하는 데 필요한 특정 정보를 조회할 수 있도록 설계되었습니다. 예를 들어 에이전트에 Mastra 기능을 추가하거나, 새 프로젝트를 스캐폴딩하거나, 특정 기능의 작동 방식을 이해하는 데 도움을 줍니다.

어떻게 동작을 하는가?

IDE에 설치한 뒤에 프롬프트를 작성하면 IDE의 에이전트가 Mastra에 대한 모든 것을 알고 있다고 생각하면 됩니다.

기능 추가

"내 에이전트에 evals를 추가하고 테스트를 작성해줘"
"다음과 같은 작업을 수행하는 워크플로우를 작성해줘 [작업]"
"에이전트가 [서드파티 API]에 접근할 수 있는 새로운 도구를 만들어줘"

Integration에 대한 질문

"Mastra가 AI SDK와 호환되나요? [React/Svelte/등] 프로젝트에서 어떻게 사용할 수 있나요?"
"MCP 관련 최신 Mastra 뉴스가 있나요?"
"Mastra가 [제공업체] 음성 및 보이스 API를 지원하나요? 내 코드에서 사용하는 방법을 예시로 보여주세요."

기존 코드 디버깅 또는 업데이트

"에이전트 메모리 관련 버그가 발생했는데, 최근에 관련 변경사항이나 버그 수정이 있었나요?"
"Mastra에서 작업 메모리가 어떻게 동작하는지, 그리고 [작업]을 수행하는 데 어떻게 사용할 수 있는지 알려주세요. 제가 예상한 대로 작동하지 않는 것 같습니다."
"새로운 워크플로우 기능들이 있다고 들었는데, 설명해주시고 [워크플로우]를 업데이트해서 해당 기능들을 사용하도록 해주세요."

그 외에도 - 궁금한 점이 있으시면 IDE에 질문해보시고 에이전트가 정보를 찾도록 하세요.

수동 설치

기존 프로젝트에 MCP Docs Server를 추가하려면 수동으로 설치해야 합니다.

Cursor: 프로젝트 루트의 .cursor/mcp.json을 편집하거나, 전역 설정의 경우 ~/.cursor/mcp.json에 추가합니다.
Windsurf: ~/.codeium/windsurf/mcp_config.json에 추가를 합니다. (전역 설정만 지원)
VSCode: 프로젝트 루트의 ~/.vscode/mcp.json에 추가를 합니다.

MacOS/Linux

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

Windows

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

2025년 7월 26일 기준 번역
by dongne.lab@gmail.com