viewgate-mcp 1.0.17 → 1.0.20

package/dist/index.js

@@ -118,7 +118,8 @@ function createMcpServer(apiKey, personalKey) {
                                         path: { type: "string", description: "The relative path of the endpoint" },
                                         method: { type: "string", description: "HTTP method (GET, POST, etc.)" },
                                         description: { type: "string", description: "Human-readable description of what the endpoint does. MUST be in the preferredLanguage." },
-                                        hash: { type: "string", description: "Optional SHA256 hash of the endpoint definition for efficient diffing." }
+                                        hash: { type: "string", description: "Optional SHA256 hash of the endpoint definition for efficient diffing." },
+                                        contract: { type: "string", description: "Optional JSON string or description of the request/response contract (payload)." }
                                     },
                                     required: ["path", "method", "description"]
                                 }
@@ -142,17 +143,6 @@ function createMcpServer(apiKey, personalKey) {
                         type: "object",
                         properties: {},
                     },
-                },
-                {
-                    name: "get_figma_preview",
-                    description: "Fetches design metadata and image previews from a Figma URL using the project's centralized access token. Use this to understand the UX requirements without needing local Figma configuration. The Figma token must be configured in the ViewGate dashboard under Settings > Integrations.",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            url: { type: "string", description: "The Figma design or file URL" }
-                        },
-                        required: ["url"]
-                    }
                 }
             ],
         };
@@ -227,18 +217,18 @@ function createMcpServer(apiKey, personalKey) {
                             tag: ann.reference?.tag,
                             figmaReference: ann.figmaReference,
                             backendEndpoints: ann.backendEndpoints || [ann.backendEndpoint].filter(Boolean),
-                            _ia_fix_instruction: `### 🎨 DESIGN CONTEXT (Figma)
-${ann.figmaReference ? `A design reference is available: ${Array.isArray(ann.figmaReference) ? (ann.figmaReference[0]?.link || ann.figmaReference[0]) : (ann.figmaReference.link || ann.figmaReference)}. Use the 'get_figma_preview' tool to fetch design details and image previews before implementing.` : 'No explicit figma design linked.'}
-
-### 🔬 SURGICAL FIX PROTOCOL (Language: ${data.preferredLanguage || 'en'})
-1. **PRIMARY**: Search for \`data-vg-id="${ann.reference?.vgId}"\`.
-2. **SECONDARY**: Check \`${file}\` L${line} (Fiber Source).
-3. **TERTIARY**: Match Tag(\`${ann.reference?.tag}\`) + Role(\`${ann.reference?.fingerprint?.role}\`) + Text("${ann.reference?.text?.slice(0, 30)}").
-4. **VALIDATE**: Confirm parent context matches \`${ann.reference?.parentContext?.slice(0, 50).replace(/`/g, "'")}...\`.
-
-IMPORTANT: All your analysis and implementation comments MUST BE IN ${data.preferredLanguage === 'es' ? 'SPANISH' : 'ENGLISH'}.
-
-Confidence: [vgId: ${ann.reference?.confidence?.vgId || 0}, Fiber: ${ann.reference?.confidence?.fiber || 0}, Fingerprint: ${ann.reference?.confidence?.fingerprint || 0}]
+                            _ia_fix_instruction: `### 🎨 DESIGN CONTEXT (Figma)
+${ann.figmaReference ? `A design reference is available: ${ann.figmaReference}. Use the Figma link to understand the UX requirements.` : 'No explicit figma design linked.'}
+
+### 🔬 SURGICAL FIX PROTOCOL (Language: ${data.preferredLanguage || 'en'})
+1. **PRIMARY**: Search for \`data-vg-id="${ann.reference?.vgId}"\`.
+2. **SECONDARY**: Check \`${file}\` L${line} (Fiber Source).
+3. **TERTIARY**: Match Tag(\`${ann.reference?.tag}\`) + Role(\`${ann.reference?.fingerprint?.role}\`) + Text("${ann.reference?.text?.slice(0, 30)}").
+4. **VALIDATE**: Confirm parent context matches \`${ann.reference?.parentContext?.slice(0, 50).replace(/`/g, "'")}...\`.
+
+IMPORTANT: All your analysis and implementation comments MUST BE IN ${data.preferredLanguage === 'es' ? 'SPANISH' : 'ENGLISH'}.
+
+Confidence: [vgId: ${ann.reference?.confidence?.vgId || 0}, Fiber: ${ann.reference?.confidence?.fiber || 0}, Fingerprint: ${ann.reference?.confidence?.fingerprint || 0}]
 Instruction: ${ann.message}`
                         };
                     });
@@ -405,108 +395,6 @@ Instruction: ${ann.message}`
                     };
                 }
             }
-            case "get_figma_preview": {
-                try {
-                    const args = request.params.arguments;
-                    const url = args.url;
-                    // 1. Get Figma Token from Backend Config
-                    const configResponse = await fetch(`${BACKEND_URL}/api/mcp/config`, {
-                        headers: {
-                            'x-api-key': apiKey,
-                            ...(personalKey ? { 'x-personal-key': personalKey } : {})
-                        }
-                    });
-                    if (!configResponse.ok) {
-                        throw new Error(`Failed to fetch project configuration: ${configResponse.status}`);
-                    }
-                    const configData = (await configResponse.json());
-                    const figmaToken = configData?.settings?.figmaToken;
-                    if (!figmaToken) {
-                        return {
-                            content: [{
-                                    type: "text",
-                                    text: "Figma integration is not fully configured. Please add a Figma Access Token in the ViewGate Dashboard (Settings > Integrations)."
-                                }],
-                            isError: true
-                        };
-                    }
-                    // 2. Parse Figma URL
-                    let fileKey = "";
-                    try {
-                        if (url.includes("/file/") || url.includes("/design/")) {
-                            const parts = url.split(/\/(?:file|design)\//)[1].split("/");
-                            fileKey = parts[0].split(/[?#]/)[0];
-                        }
-                    }
-                    catch (e) {
-                        throw new Error("Could not parse Figma File Key from URL.");
-                    }
-                    if (!fileKey) {
-                        throw new Error("Invalid Figma URL format. File key not found.");
-                    }
-                    // Extract node-id if present
-                    let nodeId = "";
-                    try {
-                        const urlObj = new URL(url.replace(/#/g, "?")); // Handle hash-based node-id
-                        nodeId = urlObj.searchParams.get("node-id") || urlObj.searchParams.get("m") || "";
-                        if (!nodeId && url.includes("node-id=")) {
-                            nodeId = url.split("node-id=")[1].split("&")[0];
-                        }
-                        // Normalización y limpieza
-                        if (nodeId) {
-                            nodeId = decodeURIComponent(nodeId).replace(/-/g, ":");
-                        }
-                    }
-                    catch (e) {
-                        // Silent fail for nodeId, might just fetch full file
-                    }
-                    // 3. Fetch Data from Figma
-                    // Use /nodes endpoint if nodeId exists, otherwise /files
-                    const encodedNodeId = nodeId ? encodeURIComponent(nodeId) : "";
-                    const figmaApiUrl = nodeId
-                        ? `https://api.figma.com/v1/files/${fileKey}/nodes?ids=${encodedNodeId}`
-                        : `https://api.figma.com/v1/files/${fileKey}`;
-                    const figmaResponse = await fetch(figmaApiUrl, {
-                        headers: { 'X-Figma-Token': figmaToken }
-                    });
-                    if (!figmaResponse.ok) {
-                        const errorText = await figmaResponse.text();
-                        throw new Error(`Figma API returned ${figmaResponse.status}: ${errorText} (URL: ${figmaApiUrl})`);
-                    }
-                    const rawData = (await figmaResponse.json());
-                    // 4. Optionally fetch image preview if a node is specified
-                    let imageUrl = null;
-                    if (nodeId) {
-                        const encodedIds = encodeURIComponent(nodeId);
-                        const imageResponse = await fetch(`https://api.figma.com/v1/images/${fileKey}?ids=${encodedIds}&scale=2&format=png`, {
-                            headers: { 'X-Figma-Token': figmaToken }
-                        });
-                        if (imageResponse.ok) {
-                            const imageData = await imageResponse.json();
-                            imageUrl = imageData.images?.[nodeId];
-                        }
-                    }
-                    const nodeInfo = nodeId ? rawData.nodes?.[nodeId] : null;
-                    return {
-                        content: [{
-                                type: "text",
-                                text: JSON.stringify({
-                                    fileName: rawData.name || "Unknown File",
-                                    lastModified: rawData.lastModified,
-                                    previewUrl: imageUrl,
-                                    nodeName: nodeInfo ? (nodeInfo.document?.name || 'Selected Component') : 'Full File',
-                                    note: "Design context successfully retrieved from Figma."
-                                }, null, 2)
-                            }]
-                    };
-                }
-                catch (error) {
-                    return {
-                        content: [{ type: "text", text: `Error fetching Figma preview: ${error.message}` }],
-                        isError: true
-                    };
-                }
-            }
             default:
                 throw new Error("Unknown tool");
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viewgate-mcp",
-  "version": "1.0.17",
+  "version": "1.0.20",
   "main": "dist/index.js",
   "bin": {
     "viewgate-mcp": "./dist/index.js"
@@ -21,7 +21,7 @@
   "license": "ISC",
   "description": "",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "cors": "^2.8.6",
     "dotenv": "^17.3.1",
     "express": "^5.2.1",