Mastergo Magic MCP

What is Mastergo Magic MCP about?

Mastergo Magic MCP provides a bridge between MasterGo design tools and AI models, allowing direct access to design DSL data, component metadata, and workflow information.

How to use Mastergo Magic MCP?

1. Generate a personal access token in MasterGo (Security Settings → Personal Access Token).
2. Run the service with npx:

   npx @mastergo/magic-mcp --token=YOUR_TOKEN [--url=API_URL] [--rule=RULE_NAME] [--debug] [--no-rule]
   

   • Optional flags can also be supplied via environment variables (MG_MCP_TOKEN, API_BASE_URL, RULES).
3. Integrate the MCP endpoint into your AI agent or tooling (e.g., Claude Desktop via Smithery, LINGMA, Cursor, Cline) by referencing the server configuration.

Key Features of Mastergo Magic MCP

• Retrieves DSL data from MasterGo design files.
• Provides tools for component links, metadata, and component‑workflow generation for Vue/React.
• Zero external dependencies; only Node.js is required.
• Supports rule‑based processing and debug mode.
• Installable via npx, Smithery, or as a local Node script.

Use Cases of Mastergo Magic MCP

• AI‑assisted design review – an LLM can query design DSL to generate feedback or suggestions.
• Automated component scaffolding – retrieve component workflow data to auto‑generate Vue/React boilerplate.
• Design‑to‑code pipelines – feed design metadata into code generation models.
• Custom agents – embed the MCP in Claude, Cursor, or other agent platforms to enable design‑aware conversations.

FAQ from the Mastergo Magic MCP

• Do I need any dependencies? No, just a recent Node.js runtime.
• What token should I use? Use the personal access token from MasterGo (named MG_MCP_TOKEN or MASTERGO_API_TOKEN).
• Can I change the API base URL? Yes, via the --url flag or API_BASE_URL environment variable.
• How do I disable default design rules? Add the --no-rule flag.
• Is there a way to run the service locally for development? Yes, build the repo with yarn && yarn build and point the MCP configuration to the generated bin/cli.js script.

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

• https://mastergo.com/file/155675508499265?page_id=158:0002

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

Command Line Options

npx @mastergo/magic-mcp --token=YOUR_TOKEN [--url=API_URL] [--rule=RULE_NAME] [--debug] [--no-rule]

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
• --debug (optional): Enable debug mode for detailed error information
• --no-rule (optional): Disable default rules

You can also use space-separated format for parameters:

npx @mastergo/magic-mcp --token YOUR_TOKEN --url API_URL --rule RULE_NAME --debug

Environment Variables

Alternatively, you can use environment variables instead of command line arguments:

• MG_MCP_TOKEN or MASTERGO_API_TOKEN: MasterGo API token
• API_BASE_URL: API base URL
• RULES: JSON array of rules (e.g., '["rule1", "rule2"]')

Installing via Smithery

To install MasterGo Magic for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @mastergo-design/mastergo-magic-mcp --client claude

LINGMA Usage

Search for LINGMA in the VSCode extension marketplace and install it.

After logging in, click on [MCP tools] in the chat box.

Click on [MCP Square] at the top to enter the MCP marketplace, find the MasterGo design collaboration tool and install it.

After installation, go back to [MCP Servers], and edit our MCP service to replace it with your own MasterGo token.

Finally, switch the chat mode to agent mode in the chat interface.

cursor Usage

Cursor Mcp usage guide reference: https://docs.cursor.com/context/model-context-protocol#using-mcp-tools-in-agent

You can configure the MCP server using either command line arguments or environment variables:

Option 1: Using command line arguments

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

Option 2: Using environment variables

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

cline Usage

Option 1: Using command line arguments

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

Option 2: Using environment variables

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

Project Structure

src Directory

The src directory contains the core implementation of the MasterGo Magic MCP service:

• index.ts: Entry point of the application that initializes the MCP server and registers all tools
• http-util.ts: Utility for handling HTTP requests to the MasterGo API
• types.d.ts: TypeScript type definitions for the project

src/tools

Contains implementations of MCP tools:

• base-tool.ts: Base class for all MCP tools
• get-dsl.ts: Tool for retrieving DSL (Domain Specific Language) data from MasterGo design files
• get-component-link.ts: Tool for retrieving component documentation from links
• get-meta.ts: Tool for retrieving metadata information
• get-component-workflow.ts: Tool providing structured component development workflow for Vue and React components, generating workflow files and component specifications

src/markdown

Contains markdown files with additional documentation:

• meta.md: Documentation about metadata structure and usage
• component-workflow.md: Component development workflow documentation guiding structured component development process

Local Development

1. Run yarn and yarn build to install dependencies and build the code
2. Find the absolute path of bin/cli.js
3. Add local MCP configuration with your token

"mastergo-mcp-local": {
  "command": "node",
  "args": [
    "absolute/path/to/bin/cli.js",
    "--token=mg_xxxxxx",
    "--url=https://mastergo.com",
    "--debug"
  ],
  "env": {}
},

4. Restart your editor to ensure the local MCP is enabled

After successful execution, you can debug based on the local running results. You can build your own MCP service based on your modifications.

We welcome your code contributions and look forward to building MasterGo's MCP service together.

License

ISC