@fridaplatform-stk/figma2frida-mcp 1.0.7 → 1.0.8

package/README.md

@@ -16,10 +16,10 @@
 
 Your AI assistant gets four specialized tools:
 
-1. **`analyze_design`** - Get design context and generated code from Figma *(main tool)*
-2. **`analyze_frame`** - Screenshot of current Figma selection for visual reference and UI analysis
-3. **`analyze_frame_extraction`** - Screenshot + metadata + design context; then call `get_components_from_library`
-4. **`get_components_from_library`** - Search your design system (Pinecone + Frida AI) by query
+1. **`figma_get_design_context`** - Generate code from Figma with automatic component matching *(main tool)*
+2. **`figma_suggest_components`** - Browse and discover design system components
+3. **`figma_get_screenshot`** - Quick visual reference from Figma
+4. **`figma_improve_layout`** - Fine-tune generated code to match Figma exactly
 
 ## 🔄 How It Works
 
@@ -37,7 +37,7 @@ Your AI assistant gets four specialized tools:
 - Connects to Figma Desktop (local MCP server)
 - Searches your component library in Pinecone
 - Uses Frida AI for intelligent component matching
-- Validates your API token via Firebase
+- Validates your session token via Firebase
 
 ## 📦 Installation
 
@@ -60,10 +60,8 @@ Add to your configuration file:
       "command": "npx",
       "args": [
         "@fridaplatform-stk/figma2frida-mcp",
-        "--project-id",
-        "YOUR_PROJECT_ID",
-        "--frida-api-token",
-        "YOUR_API_TOKEN"
+        "--session-token",
+        "YOUR_SESSION_TOKEN"
       ]
     }
   }
@@ -79,10 +77,8 @@ Add to your configuration file:
       "command": "npx",
       "args": [
         "@fridaplatform-stk/figma2frida-mcp",
-        "--project-id",
-        "YOUR_PROJECT_ID",
-        "--frida-api-token",
-        "YOUR_API_TOKEN"
+        "--session-token",
+        "YOUR_SESSION_TOKEN"
       ]
     }
   }
@@ -93,24 +89,19 @@ Add to your configuration file:
 
 Restart Claude Desktop, Cursor, or your IDE to load the MCP server.
 
-## 🔑 Getting Access Tokens
+## 🔑 Getting Session Tokens
 
 To use Figma2Frida, you need:
-- **Project ID** - Your organization's project identifier
-- **Frida API Token** - Authentication token for Frida services
+- **Session token** - Temporary authentication token used by the MCP server
 
-### How to Get Tokens
+### How to Get a Session Token
 
-**Contact the Softtek Frida Team:**
+Use the **Frida Code Copilot extension** to create/select a project and connect.
+The extension creates a session automatically and writes MCP settings for you.
 
-📧 Reach out to your organization's Frida team or Softtek Frida support to request access.
+For external agents (Cursor/Claude/Windsurf), copy the generated config from:
 
-You'll need to provide:
-- Your organization name
-- Intended use case
-- Team/project information
-
-The Frida team will provide your credentials securely.
+`~/Library/Application Support/Code/User/globalStorage/fridaplatform.fridagpt/fridagpt_mcp_settings.json`
 
 ### 💡 Recommended: Frida Code Copilot Extension
 
@@ -125,7 +116,7 @@ For the best experience, also install the **[Frida Code Copilot VS Code Extensio
 
 - **Node.js 18+**
 - **Figma Desktop** with MCP enabled
-- **Frida API Token** (contact Softtek Frida team)
+- **Valid session token** (generated by Frida Code Copilot extension)
 
 ## 🚀 Example Usage
 
@@ -148,13 +139,13 @@ The AI will automatically use the Figma2Frida tools to help you.
 ## 🐛 Troubleshooting
 
 **"Authentication failed"**
-→ Verify your Frida API token with the Softtek team
+→ Verify your `--session-token` is valid and not expired
 
 **"Not connected to Figma MCP"**
 → Make sure Figma Desktop is running with MCP enabled
 
 **"Missing required argument"**
-→ Check both `--project-id` and `--frida-api-token` are in your config
+→ Check `--session-token` is present in your config
 
 **"Rate limit exceeded"**
 → Wait a few minutes before trying again

package/dist/figma2frida.js

@@ -28,16 +28,6 @@ var writeToLog = (level, message, ...args) => {
     console.log(fullMessage);
   }
 };
-var PUBLIC_PREFIX = "FIGMA2FRIDA:";
-var writePublic = (message) => {
-  const line = `${PUBLIC_PREFIX} ${message}
-`;
-  if (isStdioMode) {
-    process.stderr.write(line);
-  } else {
-    console.error(line);
-  }
-};
 var logger = {
   debug: (message, ...args) => {
     if (getLogLevel() <= 0 /* DEBUG */) {
@@ -58,10 +48,6 @@ var logger = {
     if (getLogLevel() <= 3 /* ERROR */) {
       writeToLog("ERROR", message, ...args);
     }
-  },
-  /** User-facing message; always written to stderr with FIGMA2FRIDA: prefix. */
-  public: (message) => {
-    writePublic(message);
   }
 };
 
@@ -1638,7 +1624,7 @@ var PineconeSearchService = class {
           input: text,
           model: this.fridaEmbeddingModel,
           user_id: "pinecone-search",
-          email: "figma2frida_mcp@fridaplatform.com"
+          email: process.env.MCP_USER_EMAIL || "figma2frida_mcp@fridaplatform.com"
         })
       });
       logger.debug(`API response status: ${response.status}`);
@@ -1888,83 +1874,105 @@ ${match.technical || "No technical documentation available"}
 };
 
 // src/figma2frida/services/auth/token-validator.ts
-var VALIDATION_URL = "https://apis.f2fmcp.fridaplatform.online/authenticateMcpLogin";
-async function authenticateMcpLogin(llmopsApiKey, projectId) {
-  logger.info("\u{1F510} Authenticating MCP login...");
+var VALIDATION_URL = "https://us-central1-figma2frida-mcp.cloudfunctions.net/validateSession";
+async function validateSession(sessionToken) {
+  logger.info("\u{1F510} Validating session...");
   try {
     const response = await fetch(VALIDATION_URL, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
       },
-      body: JSON.stringify({
-        data: {
-          llmopsApiKey,
-          projectId
-        }
-      })
+      body: JSON.stringify({ sessionToken })
     });
-    const responseData = await response.json();
-    if (response.ok && "result" in responseData && responseData.result?.valid === true) {
-      logger.info(
-        `\u2705 ${responseData.result.message || "API token is valid"}`
-      );
-      return;
-    }
-    if ("error" in responseData) {
-      const error = responseData.error;
-      const errorMessage = error.message || "Unknown error";
-      const errorStatus = error.status || "UNKNOWN";
-      logger.error(`\u274C MCP login authentication failed: ${errorMessage}`);
-      logger.error(`   Status: ${errorStatus}`);
-      if (errorStatus === "RESOURCE_EXHAUSTED") {
-        logger.error("   Rate limit exceeded. Please try again later.");
-      } else if (errorStatus === "NOT_FOUND") {
-        logger.error("   Project not found. Please check your project ID.");
-      } else if (errorStatus === "PERMISSION_DENIED") {
-        logger.error(
-          "   Invalid API token. Please check your token and try again."
-        );
-      }
-      throw new Error(
-        `Authentication failed: ${errorMessage} (${errorStatus})`
-      );
+    const data = await response.json();
+    if (response.ok && data.valid === true) {
+      logger.info(`\u2705 Session valid for ${data.email}`);
+      return {
+        valid: true,
+        projectId: data.projectId,
+        llmopsApiKey: data.llmopsApiKey,
+        userId: data.userId,
+        email: data.email
+      };
     }
-    logger.error(
-      `\u274C Unexpected authentication response format: ${JSON.stringify(responseData)}`
-    );
-    throw new Error("Unexpected authentication response format");
+    const errorMessage = data.error || "Unknown error";
+    logger.error(`\u274C Session validation failed: ${errorMessage}`);
+    throw new Error(`Session validation failed: ${errorMessage}`);
   } catch (error) {
-    if (error instanceof Error && error.message.startsWith("Authentication failed:")) {
+    if (error instanceof Error && error.message.startsWith("Session validation failed:")) {
       throw error;
     }
-    logger.error(
-      "\u274C Failed to authenticate MCP login:",
-      error instanceof Error ? error.message : String(error)
-    );
+    logger.error("\u274C Failed to validate session:", error instanceof Error ? error.message : String(error));
     if (error instanceof Error) {
       if (error.message.includes("fetch failed") || error.message.includes("ECONNREFUSED")) {
-        logger.error("   Network error: Could not reach validation service.");
-        logger.error("   Please check your internet connection and try again.");
         throw new Error("Network error: Could not reach validation service");
       } else if (error.message.includes("timeout")) {
-        logger.error(
-          "   Request timeout: Validation service did not respond in time."
-        );
-        logger.error("   Please try again later.");
-        throw new Error(
-          "Request timeout: Validation service did not respond in time"
-        );
+        throw new Error("Request timeout: Validation service did not respond in time");
       }
     }
-    throw new Error(
-      `Authentication failed: ${error instanceof Error ? error.message : String(error)}`
-    );
+    throw new Error(`Session validation failed: ${error instanceof Error ? error.message : String(error)}`);
   }
 }
 
 // src/figma2frida/services/frida/frida-client.ts
 import "dotenv/config";
+function extractFromResponsesApiOutput(data) {
+  const output = data.output;
+  if (!Array.isArray(output)) {
+    return null;
+  }
+  const textParts = [];
+  for (const item of output) {
+    if (!item || typeof item !== "object") {
+      continue;
+    }
+    const o = item;
+    if (o.type !== "message") {
+      continue;
+    }
+    const content = o.content;
+    if (!Array.isArray(content)) {
+      continue;
+    }
+    for (const block of content) {
+      if (!block || typeof block !== "object") {
+        continue;
+      }
+      const b = block;
+      if (b.type === "output_text" && typeof b.text === "string" && b.text.length > 0) {
+        textParts.push(b.text);
+      }
+    }
+  }
+  const joined = textParts.join("\n").trim();
+  if (!joined) {
+    return null;
+  }
+  const parseSource = data.object === "response" ? "response.output[].message.output_text" : "output[].message.output_text";
+  return { answer: joined, parseSource };
+}
+function parseFridaAnswer(data) {
+  if (typeof data.response === "string" && data.response) {
+    return { answer: data.response, parseSource: "response" };
+  }
+  const structured = extractFromResponsesApiOutput(data);
+  if (structured) {
+    return structured;
+  }
+  if (typeof data.output === "string" && data.output) {
+    return { answer: data.output, parseSource: "output" };
+  }
+  const choices = data.choices;
+  const msg = choices?.[0]?.message;
+  if (msg && typeof msg.content === "string" && msg.content) {
+    return { answer: msg.content, parseSource: "choices[0].message.content" };
+  }
+  if (typeof data.content === "string" && data.content) {
+    return { answer: data.content, parseSource: "content" };
+  }
+  return { answer: JSON.stringify(data), parseSource: "fallback_json" };
+}
 var FridaClient = class {
   apiKey;
   apiUrl;
@@ -2078,7 +2086,7 @@ Example format: tag1, tag2, tag3
           input: prompt,
           max_tokens: this.maxTokens,
           stream: false,
-          email: "figma_2frida_mcp@softtek.com"
+          email: process.env.MCP_USER_EMAIL || "figma2frida_mcp@fridaplatform.com"
         })
       });
       const fetchTime = Date.now() - startTime;
@@ -2088,18 +2096,19 @@ Example format: tag1, tag2, tag3
         throw new Error(`API Error: ${response.status} ${response.statusText}`);
       }
       const data = await response.json();
-      logger.debug("Response received successfully");
-      const answer = data.response || data.output || data.choices?.[0]?.message?.content || data.content || JSON.stringify(data);
+      const { answer, parseSource } = parseFridaAnswer(data);
       const tokensUsed = data.usage?.total_tokens || null;
-      const answerLength = typeof answer === "string" ? answer.length : String(answer).length;
-      logger.debug("FRIDA AI RESPONSE RECEIVED");
-      logger.debug(`TOKENS USED: ${tokensUsed || "N/A"}`);
-      logger.debug(`Answer length: ${answerLength} chars`);
-      logger.debug(`Total time: ${fetchTime}ms`);
+      const answerPreview = answer.replace(/\s+/g, " ").slice(0, 200);
+      logger.debug(
+        `Frida answer preview (ask): "${answerPreview}" (from "${parseSource}")`
+      );
+      logger.debug(
+        `Frida response OK (ask): HTTP ${response.status} in ${fetchTime}ms \u2014 parsed from "${parseSource}", ${answer.length} chars, tokens=${tokensUsed ?? "n/a"}`
+      );
       return {
         success: true,
         error: null,
-        response: typeof answer === "string" ? answer : String(answer),
+        response: answer,
         metadata: {
           model: this.model,
           tokensUsed
@@ -2156,7 +2165,7 @@ Example format: tag1, tag2, tag3
           input: prompt,
           max_tokens: this.maxTokens,
           stream: false,
-          email: "figma_2frida_mcp@softtek.com"
+          email: process.env.MCP_USER_EMAIL || "figma2frida_mcp@fridaplatform.com"
         })
       });
       const fetchTime = Date.now() - startTime;
@@ -2166,18 +2175,19 @@ Example format: tag1, tag2, tag3
         throw new Error(`API Error: ${response.status} ${response.statusText}`);
       }
       const data = await response.json();
-      logger.debug("Response received successfully");
-      const answer = data.response || data.output || data.choices?.[0]?.message?.content || data.content || JSON.stringify(data);
+      const { answer, parseSource } = parseFridaAnswer(data);
       const tokensUsed = data.usage?.total_tokens || null;
-      const answerLength = typeof answer === "string" ? answer.length : String(answer).length;
-      logger.debug("FRIDA AI FILTER RESPONSE RECEIVED");
-      logger.debug(`TOKENS USED: ${tokensUsed || "N/A"}`);
-      logger.debug(`Answer length: ${answerLength} chars`);
-      logger.debug(`Total time: ${fetchTime}ms`);
+      const answerPreview = answer.replace(/\s+/g, " ").slice(0, 200);
+      logger.debug(
+        `Frida answer preview (filter): "${answerPreview}" (from "${parseSource}")`
+      );
+      logger.debug(
+        `Frida response OK (filter): HTTP ${response.status} in ${fetchTime}ms \u2014 parsed from "${parseSource}", ${answer.length} chars, tokens=${tokensUsed ?? "n/a"}`
+      );
       return {
         success: true,
         error: null,
-        response: typeof answer === "string" ? answer : String(answer),
+        response: answer,
         metadata: {
           model: this.model,
           tokensUsed
@@ -2294,12 +2304,12 @@ logger.debug("Loading hardcoded configuration...");
 process.env.PINECONE_INDEX = "figma2frida";
 process.env.PINECONE_MIN_SCORE = "0.4";
 process.env.PINECONE_TOP_K = "12";
-process.env.FRIDA_PINECONE_PROXY_URL = "https://frida.azure-api.net/pinecone-proxy";
-process.env.FRIDA_API_URL = "https://frida.azure-api.net/frida-llm-api/v1/responses";
-process.env.FRIDA_EMBEDDING_URL = "https://frida.azure-api.net/frida-llm-api/v1/embeddings";
+process.env.FRIDA_PINECONE_PROXY_URL = "https://azf-frida-pinecone-proxy.azurewebsites.net";
+process.env.FRIDA_API_URL = "https://frida-llm-api-dev.azurewebsites.net/v1/responses";
+process.env.FRIDA_EMBEDDING_URL = "https://frida-llm-api.azurewebsites.net/v1/embeddings";
 process.env.FRIDA_EMBEDDING_MODEL = "text-embedding-ada-002";
 process.env.FRIDA_MODEL = "gpt-5.1-codex";
-process.env.FRIDA_MAX_TOKENS = "9000";
+process.env.FRIDA_MAX_TOKENS = "12000";
 process.env.HTTP_STREAM = "false";
 process.env.PORT = "8080";
 logger.debug(`PINECONE_INDEX: ${process.env.PINECONE_INDEX}`);
@@ -2314,35 +2324,28 @@ logger.debug(`FRIDA_MAX_TOKENS: ${process.env.FRIDA_MAX_TOKENS}`);
 logger.debug(`HTTP_STREAM: ${process.env.HTTP_STREAM}`);
 logger.debug(`PORT: ${process.env.PORT}`);
 logger.info("Configuration loaded");
-var argv = yargs(hideBin(process.argv)).option("project-id", {
-  type: "string",
-  description: "Pinecone namespace (required for component search)",
-  demandOption: true
-}).option("frida-api-token", {
+var argv = yargs(hideBin(process.argv)).option("session-token", {
   type: "string",
-  description: "Frida API token for authentication",
+  description: "Session token for authentication",
   demandOption: true
 }).parseSync();
-var PINECONE_NAMESPACE = argv.projectId?.trim();
-if (!PINECONE_NAMESPACE || PINECONE_NAMESPACE === "" || PINECONE_NAMESPACE === "your_namespace_here") {
-  logger.error("\u274C SHUTDOWN: Invalid or missing --project-id. This argument is required for Pinecone search.");
-  process.exit(1);
-}
-logger.debug(`PINECONE_NAMESPACE: ${PINECONE_NAMESPACE} (from CLI)`);
-var FRIDA_TOKEN = argv.fridaApiToken?.trim();
-if (!FRIDA_TOKEN || FRIDA_TOKEN === "" || FRIDA_TOKEN === "your_api_token_here") {
-  logger.error("\u274C SHUTDOWN: Invalid or missing --frida-api-token. This token is required for authentication.");
+var SESSION_TOKEN = argv.sessionToken?.trim();
+if (!SESSION_TOKEN || SESSION_TOKEN === "") {
+  logger.error("\u274C SHUTDOWN: Invalid or missing --session-token.");
   process.exit(1);
 }
-process.env.FRIDA_BEARER_TOKEN = FRIDA_TOKEN;
-logger.debug(`FRIDA_API_TOKEN: ${FRIDA_TOKEN.substring(0, 8)}... (hidden)`);
+var PINECONE_NAMESPACE = "";
 try {
-  await authenticateMcpLogin(FRIDA_TOKEN, argv.projectId);
+  const session = await validateSession(SESSION_TOKEN);
+  PINECONE_NAMESPACE = session.projectId;
+  process.env.FRIDA_BEARER_TOKEN = session.llmopsApiKey;
+  process.env.MCP_USER_EMAIL = session.email;
+  process.env.MCP_USER_ID = session.userId;
+  logger.info(`Authenticated as ${session.email}`);
+  logger.debug(`PINECONE_NAMESPACE: ${PINECONE_NAMESPACE}`);
+  logger.debug(`FRIDA_BEARER_TOKEN: ${session.llmopsApiKey.substring(0, 8)}... (hidden)`);
 } catch (error) {
-  logger.error("\u274C SHUTDOWN: Authentication failed. MCP server cannot start without valid token.");
-  logger.public(
-    `\u274C ${error instanceof Error ? error.message : String(error)}`
-  );
+  logger.error("\u274C SHUTDOWN: Session validation failed. MCP server cannot start.");
   process.exit(1);
 }
 var HTTP_STREAM = process.env.HTTP_STREAM === "true" || process.env.HTTP_STREAM === "1";
@@ -2670,7 +2673,7 @@ if (HTTP_STREAM) {
   });
   logger.info("Figma Proxy MCP Server running on HTTP Stream!");
   logger.info(`Endpoint: http://localhost:${PORT}/mcp`);
-  logger.debug(`Pinecone Namespace: ${PINECONE_NAMESPACE || "not set (use --project-id)"}`);
+  logger.debug(`Pinecone Namespace: ${PINECONE_NAMESPACE}`);
   logger.debug(`
 Test with curl:
 curl -X POST http://localhost:${PORT}/mcp \\