@mastergo/magic-mcp 0.1.9-alpha.0 → 0.2.0

package/README.md

@@ -14,6 +14,40 @@ MasterGo Magic MCP is a standalone MCP (Model Context Protocol) service designed
 
 - [https://mastergo.com/file/192644601973042](https://mastergo.com/file/192644601973042)
 
+## 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
@@ -115,7 +149,7 @@ You can configure the MCP server using either command line arguments or environm
       "args": [
         "-y",
         "@mastergo/magic-mcp",
-        "--token=<MG_MCP_TOKEN>",
+        "--token=<YOUR_TOKEN>",
         "--url=https://mastergo.com"
       ],
       "env": {}
@@ -141,6 +175,24 @@ You can configure the MCP server using either command line arguments or environm
 }
 ```
 
+**Option 3: Using SSE (Streamable HTTP)**
+
+No local installation required. The MCP server runs remotely and is accessed via SSE:
+
+```json
+{
+  "mcpServers": {
+    "mastergo-magic-mcp": {
+      "type": "http",
+      "url": "https://mastergo.com/mcp/xf/sse",
+      "headers": {
+        "x-mg-useraccesstoken": "<YOUR_TOKEN>"
+      }
+    }
+  }
+}
+```
+
 ### cline Usage
 
 **Option 1: Using command line arguments**
@@ -153,7 +205,7 @@ You can configure the MCP server using either command line arguments or environm
       "args": [
         "-y",
         "@mastergo/magic-mcp",
-        "--token=<MG_MCP_TOKEN>",
+        "--token=<YOUR_TOKEN>",
         "--url=https://mastergo.com"
       ],
       "env": {}
@@ -179,6 +231,31 @@ You can configure the MCP server using either command line arguments or environm
 }
 ```
 
+### Open Code Usage
+
+Open Code uses a `mcp` configuration block with `type: "local"` and `command` array:
+
+```json
+{
+  "mcp": {
+    "mastergo-magic-mcp": {
+      "type": "local",
+      "command": [
+        "npx",
+        "-y",
+        "@mastergo/magic-mcp",
+        "--token=<YOUR_TOKEN>",
+        "--url=https://mastergo.com"
+      ],
+      "environment": {
+        "NPM_CONFIG_REGISTRY": "https://registry.npmjs.org/"
+      },
+      "enabled": true
+    }
+  }
+}
+```
+
 ## Project Structure
 
 ### src Directory

package/README.zh-CN.md

@@ -14,6 +14,40 @@ MasterGo Magic MCP 是一个独立的 MCP（Model Context Protocol）服务，
 
 - [https://mastergo.com/file/192644601973042](https://mastergo.com/file/192644601973042)
 
+## 示例提示词
+
+MCP 服务连接成功后，可以在 AI 对话中使用以下提示词：
+
+**提取 SVG，放到 html 中预览：**
+
+```
+提取 SVG，放到 html 中预览：https://{domain}/file/{fileId}?layer_id={layerId}
+```
+
+**还原设计稿为代码：**
+
+```
+还原设计稿：https://{domain}/file/{fileId}?layer_id={layerId}
+```
+
+将 `{domain}`、`{fileId}`、`{layerId}` 替换为实际值。也可以使用短链接：
+
+```
+还原设计稿：https://{domain}/goto/{shortLink}
+```
+
+**还原设计稿并保存为 HTML 文件：**
+
+```
+还原设计稿，保存为 html 文件：https://{domain}/file/{fileId}?layer_id={layerId}
+```
+
+也可以使用短链接：
+
+```
+还原设计稿，保存为 html 文件：https://{domain}/goto/{shortLink}
+```
+
 ## 使用方法
 
 ### 获取 MG_MCP_TOKEN
@@ -114,7 +148,7 @@ Cursor Mcp 使用指南参考：https://docs.cursor.com/context/model-context-pr
       "args": [
         "-y",
         "@mastergo/magic-mcp",
-        "--token=<MG_MCP_TOKEN>",
+        "--token=<YOUR_TOKEN>",
         "--url=https://mastergo.com"
       ],
       "env": {}
@@ -140,6 +174,24 @@ Cursor Mcp 使用指南参考：https://docs.cursor.com/context/model-context-pr
 }
 ```
 
+**方式三：使用 SSE（Streamable HTTP）**
+
+无需本地安装，MCP 服务在远端运行，通过 SSE 访问：
+
+```json
+{
+  "mcpServers": {
+    "mastergo-magic-mcp": {
+      "type": "http",
+      "url": "https://mastergo.com/mcp/xf/sse",
+      "headers": {
+        "x-mg-useraccesstoken": "<YOUR_TOKEN>"
+      }
+    }
+  }
+}
+```
+
 ### cline 使用方法
 
 **方式一：使用命令行参数**
@@ -152,7 +204,7 @@ Cursor Mcp 使用指南参考：https://docs.cursor.com/context/model-context-pr
       "args": [
         "-y",
         "@mastergo/magic-mcp",
-        "--token=<MG_MCP_TOKEN>",
+        "--token=<YOUR_TOKEN>",
         "--url=https://mastergo.com"
       ],
       "env": {}
@@ -178,6 +230,31 @@ Cursor Mcp 使用指南参考：https://docs.cursor.com/context/model-context-pr
 }
 ```
 
+### Open Code 使用方法
+
+Open Code 使用 `mcp` 配置块，通过 `type: "local"` 和 `command` 数组来配置：
+
+```json
+{
+  "mcp": {
+    "mastergo-magic-mcp": {
+      "type": "local",
+      "command": [
+        "npx",
+        "-y",
+        "@mastergo/magic-mcp",
+        "--token=<YOUR_TOKEN>",
+        "--url=https://mastergo.com"
+      ],
+      "environment": {
+        "NPM_CONFIG_REGISTRY": "https://registry.npmjs.org/"
+      },
+      "enabled": true
+    }
+  }
+}
+```
+
 ## 项目结构
 
 ### src 目录