Mastergo Magic Mcp

Name: Mastergo Magic Mcp
Author: mastergo-design

@mastergo-design

Mastergo Magic Mcp について

MasterGo Magic MCP is a standalone MCP (Model Context Protocol) service designed to connect MasterGo design tools with AI models.

#mastergo #mcp #ai-integration

基本情報

カテゴリ

その他

ランタイム

node

トランスポート

stdio

公開者

mastergo-design

投稿者

JiaLun_Yao

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mastergo-magic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mastergo/magic-mcp",
        "--token=your_token",
        "--url=https://mastergo.com/"
      ],
      "env": {
        "NPM_CONFIG_REGISTRY": "https://registry.npmjs.org/"
      }
    }
  }
}

ツール

"Use this tool to retrieve the DSL (Domain Specific Language) data from MasterGo design files and the rules you must follow when generating code. This tool is useful when you need to analyze the structure of a design, understand component hierarchy, or extract design properties. You must provide a fileId and layerId to identify the specific design element. This tool returns the raw DSL data in JSON format that you can then parse and analyze. This tool also returns the rules you must follow when generating code. The DSL data can also be used to transform and generate code for different frameworks."

When the data returned by mcp__getDsl contains a non-empty componentDocumentLinks array, this tool is used to sequentially retrieve URLs from the componentDocumentLinks array and then obtain component documentation data. The returned document data is used for you to generate frontend code based on components.

概要

What is Mastergo Magic Mcp?

Mastergo Magic Mcp is a standalone MCP (Model Context Protocol) service that connects MasterGo design tools with AI models. It enables AI models to directly retrieve DSL (Domain Specific Language) data from MasterGo design files, allowing AI-powered design-to-code workflows.

How to use Mastergo Magic Mcp?

Run the service directly with npx @mastergo/magic-mcp --token=YOUR_TOKEN. You can also configure it via environment variables or install it through the Smithery marketplace. The server integrates with MCP clients such as Claude Desktop, Cursor, Cline, Open Code, and LINGMA. Obtain a MasterGo personal access token from your account Security Settings (Team Edition or higher required). Design files must be placed in Team Projects, not the draft box.

Key features of Mastergo Magic Mcp

Retrieves DSL data from MasterGo design files
Runs directly with npx, no external dependencies
Supports multiple output formats: json, yaml, tree
Works with short links for design files
Supports HTTP/HTTPS proxy and custom headers
Debug mode for detailed error information

Use cases of Mastergo Magic Mcp

Extract SVG from a design layer and preview in HTML
Restore a design to code (e.g., Vue or React components)
Restore a design and save as an HTML file
Generate structured component development workflows
Retrieve component documentation from links

FAQ from Mastergo Magic Mcp

What token is required to use Mastergo Magic Mcp?

You need a MasterGo personal access token (MG_MCP_TOKEN). Generate it in your MasterGo account Security Settings. The token is passed via --token or the MG_MCP_TOKEN environment variable.

Does Mastergo Magic Mcp require a paid MasterGo account?

Yes, the tool requires a Team Edition or higher MasterGo account. Personal free accounts do not support MCP tool access.

Can Mastergo Magic Mcp access files in the draft box?

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

What output formats does Mastergo Magic Mcp support?

The design-data tools support three formats: json (default), yaml, and tree. The format can be set per call via a format parameter or globally via --format / DEFAULT_FORMAT. All formats round-trip without data loss.

How can I install Mastergo Magic Mcp via Smithery?

Visit the Smithery Marketplace page for Mastergo Magic Mcp, click "Connect" or "Install", select your MCP client (e.g., Claude Desktop, Cursor), and follow the prompts to complete configuration.