MD

mastergo-design/mastergo-magic-mcp

Developer tools공식

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

286 stars 51 forks 품질 83 트렌드 39

MasterGo Magic MCP는 MasterGo 설계 도구와 AI 모델을 연결하기 위해 설계된 독립형 MCP(모델 컨텍스트 프로토콜) 서비스입니다.

개요

MasterGo Magic MCP는 마스터고 설계 도구와 AI 모델을 연결하기 위해 설계된 독립형 MCP(모델 컨텍스트 프로토콜) 서비스입니다. 이 서비스는 AI 모델이 마스터고 설계 파일에서 DSL 데이터를 직접 가져올 수 있도록 합니다. - MasterGo 설계 파일에서 DSL 데이터를 가져오기 - npx와 직접 실행 - 외부 의존성이 필요 없고 Node.js 환경만 필요합니다 - https://mastergo.com/file/192644601973042 MCP 서버가 연결되면 AI 채팅에서 다음 프롬프트를 사용할 수 있습니다: {domain}, {fileId}, {layerId}를 실제 값으로 교체하세요. 짧은 링크도 사용할 수 있습니다: 1. https://mastergo.com 방문 2. 개인 설정 입력 3. 보안 설정 탭 클릭 4. 개인 접근 토큰 찾기 5. 토큰 생성 클릭 : 도구가 연결되어 있지만 "무허가" 오류를 반환한다면, 다음 조건들을 확인해 주세요: 1. : - 마스터고 계정 이상이 필요함 - 개인용 무료 에디션은 MCP 도구 접근을 지원하지 않습니다

개요(AI 번역)

MasterGo Magic MCP는 마스터고 설계 도구와 AI 모델을 연결하기 위해 설계된 독립형 MCP(모델 컨텍스트 프로토콜) 서비스입니다. 이 서비스는 AI 모델이 마스터고 설계 파일에서 DSL 데이터를 직접 가져올 수 있도록 합니다.

주요 특징

  • MasterGo 설계 파일에서 DSL 데이터를 가져옴
  • NPX와 직접 연결됨
  • 외부 의존성이 필요 없고 환경만 Node.js 필요

튜토리얼

예시 프롬프트

MCP 서버가 연결되면 AI 채팅에서 다음 프롬프트를 사용할 수 있습니다:

SVG 추출 및 HTML에서 미리보기:

설계를 코드에 복원하기:

{domain}, {fileId}, {layerId}를 실제 값으로 대체하세요. 짧은 링크도 사용할 수 있습니다:

디자인을 복원하고 HTML 파일 저장하기:

짧은 링크도 사용할 수 있습니다:

사용

MG_MCP_TOKEN 얻기

  1. 방문하기 https://mastergo.com
  2. 개인 설정 입력
  3. 보안 설정 탭 클릭
  4. 개인 접근 토큰 찾기
  5. 토큰을 생성하기 위해 클릭

허가 요건

중요: 도구가 연결되어 있지만 “무허가” 오류를 반환하는 경우, 다음 조건을 확인해 주세요:

  1. 계정 버전 요구 사항:

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

MasterGo Magic MCP

MasterGo Magic MCP is a standalone MCP (Model Context Protocol) service designed to connect MasterGo design tools with AI models. It enables AI models to directly retrieve DSL data from MasterGo design files.

Key Features

  • Retrieves DSL data from MasterGo design files
  • Runs directly with npx
  • No external dependencies required, only Node.js environment needed

Tutorial

Example Prompts

Once the MCP server is connected, you can use the following prompts in your AI chat:

Extract SVG and preview in HTML:

Extract SVG and preview in HTML: https://{domain}/file/{fileId}?layer_id={layerId}

Restore a design to code:

Restore design: https://{domain}/file/{fileId}?layer_id={layerId}

Replace {domain}, {fileId}, and {layerId} with your actual values. You can also use short links:

Restore design: https://{domain}/goto/{shortLink}

Restore a design and save as an HTML file:

Restore design, save as HTML file: https://{domain}/file/{fileId}?layer_id={layerId}

You can also use short links:

Restore design, save as HTML file: https://{domain}/goto/{shortLink}

Usage

Obtaining MG_MCP_TOKEN

  1. Visit https://mastergo.com
  2. Enter personal settings
  3. Click the Security Settings tab
  4. Find the personal access token
  5. Click to generate the token

Permission Requirements

Important: If the tool is connected but returns a “no permission” error, please check the following conditions:

  1. Account Version Requirement:

    • Requires Team Edition or higher MasterGo account
    • Personal free edition does not support MCP tool access
  2. File Location Requirement:

    • Design files must be placed in Team Projects
    • Files in draft box cannot be accessed via MCP tools

Command Line Options

npx @mastergo/magic-mcp --token=YOUR_TOKEN [--url=API_URL] [--rule=RULE_NAME] [--proxy=PROXY_URL] [--format=FORMAT] [--header "Key: Value"] [--debug] [--no-rule] [--no-prefix]

Parameters:

  • --token=YOUR_TOKEN (required): MasterGo API token for authentication
  • --url=API_URL (optional): API base URL, defaults to http://localhost:3000
  • --rule=RULE_NAME (optional): Add design rules to apply, can be used multiple times
  • --proxy=PROXY_URL (optional): HTTP/HTTPS proxy URL (e.g., http://127.0.0.1:7890), also supports HTTPS_PROXY / HTTP_PROXY environment variables
GitHub에서 전체 README 보기

설치

npx -y @mastergo/magic-mcp --token=<YOUR_TOKEN> --url=https://mastergo.com
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "mastergo-magic-mcp": { "command": "npx", "args": [ "-y", "@mastergo/magic-mcp", "--token=<YOUR_TOKEN>", "--url=https://mastergo.com" ], "env": {} } } }