MD

mastergo-design/mastergo-magic-mcp

Developer tools公式

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

286 stars 51 forks 品質 83 トレンド 39

MasterGo Magic MCPは、MasterGo設計ツールとAIモデルを接続するために設計されたスタンドアロンのMCP(Model Context Protocol)サービスです。

概要

MasterGo Magic MCPは、MasterGo設計ツールとAIモデルを接続するために設計されたスタンドアロンのMCP(Model Context Protocol)サービスです。これにより、AIモデルがMasterGo設計ファイルから直接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. : - MasterGoアカウント以上の条件 - 個人無料版はMCPツールへのアクセスをサポートしません

概要(AI 翻訳)

MasterGo Magic MCPは、MasterGo設計ツールとAIモデルを接続するために設計されたスタンドアロンのMCP(Model Context Protocol)サービスです。これにより、AIモデルがMasterGo設計ファイルから直接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": {} } } }