MasterGo

What is MasterGo Magic MCP?

MasterGo Magic MCP is a standalone Model Context Protocol (MCP) service that bridges MasterGo design tools with AI models. Its primary function is to allow AI models to directly access and retrieve Domain Specific Language (DSL) data from MasterGo design files.

How to use MasterGo Magic MCP?

MasterGo Magic MCP can be used via command line, installed through Smithery for Claude Desktop, or integrated with LINGMA and Cursor. For command-line usage, you need to obtain an MG_MCP_TOKEN from your MasterGo personal settings. Then, you can run the service using npx @mastergo/magic-mcp --token=YOUR_TOKEN. Optional parameters include --url for API base URL, --rule for applying design rules, and --debug for detailed error information. For LINGMA, install the extension in VSCode, log in, and then install the MasterGo design collaboration tool from the MCP marketplace. For Cursor and Cline, specific JSON configurations are provided for integration.

Key Features of MasterGo Magic MCP

• Retrieves DSL data: Directly extracts DSL data from MasterGo design files.
• Standalone execution: Runs directly with npx.
• No external dependencies: Requires only a Node.js environment.
• Tooling for AI models: Provides tools like get-dsl, get-component-link, get-meta, and get-component-workflow for AI models to interact with design data.

Use Cases of MasterGo Magic MCP

• AI-powered design analysis: AI models can analyze design files by retrieving DSL data.
• Automated component documentation: AI can access component documentation links.
• Metadata retrieval: AI can get metadata information from design files.
• Structured component development: AI can assist in generating workflow files and component specifications for Vue and React components.
• Integration with AI assistants: Seamlessly integrates with AI assistants like Claude Desktop (via Smithery), LINGMA, and Cursor for enhanced design workflows.

FAQ about MasterGo Magic MCP

• What is DSL data? DSL (Domain Specific Language) data refers to the structured information within MasterGo design files that describes the design elements and their properties.
• Do I need to install anything besides Node.js? No, MasterGo Magic MCP is designed to run without external dependencies, only requiring a Node.js environment.
• How do I get an MG_MCP_TOKEN? You can generate an MG_MCP_TOKEN from the Security Settings tab within your personal settings on the MasterGo website.
• Can I use MasterGo Magic MCP with other AI tools? Yes, it is designed to be integrated with various AI models and platforms, with specific instructions provided for LINGMA and Cursor.
• How can I contribute to MasterGo Magic MCP? The project welcomes code contributions. You can set up a local development environment by running yarn and yarn build, then configuring a local MCP with your token.

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]

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

You can also use space-separated format for parameters:

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

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

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

cline Usage

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

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