MasterGo Magic MCP 서버

“MasterGo Magic” MCP 서버는 무엇을 하나요?

MasterGo Magic MCP는 MasterGo 디자인 도구와 AI 모델을 연결하도록 설계된 독립 실행형 Model Context Protocol(MCP) 서비스입니다. 이 서버는 AI 모델이 MasterGo 디자인 파일에서 DSL(도메인 특화 언어) 데이터를 직접 가져올 수 있도록 하여, 디자인 에셋과 AI 기반 워크플로우 간의 경계를 허물고 원활한 통합을 실현합니다. 이를 통해 분석, 변환, 디자인 컴포넌트 생성 등 디자인 관련 작업의 개발과 자동화를 가속화할 수 있습니다. 서버는 Node.js 환경만 있으면 별도의 외부 의존성 없이 독립적으로 동작하여, 디자인에서 AI로 연결되는 파이프라인을 강화하려는 팀에 최적화된 솔루션입니다.

프롬프트 목록

제공된 저장소에 문서화된 프롬프트 템플릿이 없습니다.

리소스 목록

이용 가능한 파일에서 명시된 MCP 리소스가 없습니다.

도구 목록

server.py 또는 제공된 링크의 저장소 파일에서 문서화된 명시적 도구가 없습니다.

이 MCP 서버의 활용 사례

• 자동 디자인 분석: AI 모델이 MasterGo 디자인 파일의 DSL 데이터를 가져와, 수동 다운로드나 전처리 없이 디자인 에셋을 자동으로 검사하거나 품질 체크를 수행할 수 있습니다.
• 디자인 협업: MCP를 통해 디자인 데이터를 노출함으로써, 팀이 AI 기반 리뷰·제안·문서화를 소스 파일에서 직접 수행하는 워크플로우를 구축할 수 있습니다.
• AI 기반 디자인 생성: 생성형 AI와 연동해, 프로젝트 파일을 바탕으로 새로운 디자인 요소나 변형안을 MCP 서버를 통해 제안받을 수 있습니다.
• 규칙 기반 디자인 검증: MCP의 --rule 파라미터를 활용해 조직 또는 프로젝트별 맞춤 디자인 규칙을 자동 적용 및 검증할 수 있습니다.

설치 방법

Windsurf

1. 시스템에 Node.js가 설치되어 있는지 확인하세요.
2. MasterGo 개인 보안 설정에서 API 토큰을 발급받으세요.
3. Windsurf 설정 파일을 엽니다.
4. mcpServers 섹션에 아래 JSON을 추가하세요:

   {
     "mastergo-magic": {
       "command": "npx",
       "args": ["@mastergo/magic-mcp@latest", "--token", "${MG_MCP_TOKEN}"]
     }
   }
   

5. 저장 후 Windsurf를 재시작하세요.

참고: API 토큰은 환경 변수에 저장해 안전하게 관리하세요:

{
  "env": {
    "MG_MCP_TOKEN": "<your-token-here>"
  }
}

Claude

1. Node.js가 설치되어 있지 않다면 설치하세요.
2. MasterGo API 토큰을 발급받으세요.
3. Claude의 MCP 서버 설정 파일을 찾으세요.
4. 아래 구성을 삽입하세요:

   {
     "mcpServers": {
       "mastergo-magic": {
         "command": "npx",
         "args": ["@mastergo/magic-mcp@latest", "--token", "${MG_MCP_TOKEN}"]
       }
     }
   }
   

5. 저장 후 Claude를 재시작하세요.

참고: 토큰은 반드시 환경 변수(MG_MCP_TOKEN)로 관리하세요.

Cursor

1. Node.js 환경을 설치하세요.
2. MasterGo 개인 액세스 토큰을 발급받으세요.
3. Cursor의 MCP 서버 설정 파일을 엽니다.
4. 아래와 같이 구성하세요:

   {
     "mcpServers": {
       "mastergo-magic": {
         "command": "npx",
         "args": ["@mastergo/magic-mcp@latest", "--token", "${MG_MCP_TOKEN}"]
       }
     }
   }
   

5. 저장 후 Cursor를 재시작하세요.

참고: 민감한 정보는 환경 변수로 관리하세요:

{
  "env": {
    "MG_MCP_TOKEN": "<your-token-here>"
  }
}

Cline

1. Node.js가 설치되어 있는지 확인하세요.
2. MasterGo 계정에서 API 토큰을 발급받으세요.
3. Cline 설정 파일에 아래 내용을 추가하세요:

   {
     "mcpServers": {
       "mastergo-magic": {
         "command": "npx",
         "args": ["@mastergo/magic-mcp@latest", "--token", "${MG_MCP_TOKEN}"]
       }
     }
   }
   

4. 파일을 저장하고 Cline을 재시작하세요.
5. 서버가 정상적으로 접근 가능한지 확인하세요.

참고: 토큰은 반드시 환경 변수로 설정하세요.

플로우에서 MCP 사용 방법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로우에 MCP 서버를 통합하려면, MCP 컴포넌트를 플로우에 추가하고 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭해 설정 패널을 엽니다. 시스템 MCP 설정 섹션에 아래와 같은 형식으로 MCP 서버 정보를 입력하세요:

{
  "mastergo-magic": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

설정 후 AI 에이전트가 해당 MCP의 모든 기능에 접근할 수 있습니다. “mastergo-magic"은 실제 MCP 서버 이름으로, URL은 본인의 MCP 서버 주소로 변경하세요.

개요

위 내용을 종합하면, MasterGo Magic MCP는 개요와 설치 안내는 명확하게 제공하지만, MCP 통합에 중요한 리소스·프롬프트 템플릿·도구 문서는 부족합니다. 샘플링 및 roots 지원도 명시되어 있지 않아, MCP 에코시스템과의 즉시 호환성 점수에 제한이 있습니다.

MCP 점수