home / mcp / mastergo magic mcp server

MasterGo Magic MCP Server

Standalone MCP service that connects MasterGo design tools with AI models to retrieve DSL data from design files.

Installation

Add the following to your MCP client configuration file.

Configuration

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

MasterGo Magic MCP is a standalone MCP service that connects MasterGo design tools with AI models. It enables AI models to directly retrieve DSL data from MasterGo design files, giving you a streamlined path to integrate design data with AI workflows.

How to use

You run the MCP client to connect to MasterGo Magic MCP and authorize it with a token. Provide your MasterGo API token, optional API URL, and any design rules you want to apply. You can enable a verbose debugging mode to help troubleshoot issues.

Practical steps you can follow: 1) Generate a personal access token from your MasterGo account. 2) Start the MCP client with your token and, if needed, a specific API URL. 3) Optionally add design rules to refine how DSL data is retrieved for your AI models. 4) If you hit errors, enable the --debug flag to get more details for troubleshooting.

A typical invocation uses the token and optional arguments to tailor the data access. The client supports multiple rules and a debug mode to help diagnose issues during development and integration.

How to install

Prerequisites: ensure you have Node.js installed on your system. You can verify by running node --version and npm --version. You do not need other dependencies to run MasterGo Magic MCP.

Install and run using the package runner with npx. The token and optional parameters are provided on the command line.

Step-by-step commands you can run:

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

# You can also use a space-separated format:
npx @mastergo/magic-mcp --token YOUR_TOKEN --url API_URL --rule RULE_NAME --debug

Additional sections

Configuration example for running MasterGo Magic MCP from your MCP client is shown below. This configuration uses npx to invoke the MCP, passes your token, and sets the MasterGo URL. You can adapt this to your environment and integrate it into your MCP workflow.

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

Notes on security and usage

Treat your MG_MCP_TOKEN as a sensitive credential. Store it securely and do not expose it in logs or shared scripts. If you add design rules, they are used to adapt how DSL data is retrieved for your AI models.