@liner-fe/figma-mcp 1.0.4 → 1.0.6

package/dist/server/server.cjs

@@ -24,103 +24,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // src/server.ts
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
-
-// src/figmaClient.ts
 var import_crypto = require("crypto");
 var import_ws = __toESM(require("ws"), 1);
-function createFigmaClient({ logger: logger2, serverUrl: serverUrl2, wsUrlBase }) {
-  let ws = null;
-  const pendingRequests = /* @__PURE__ */ new Map();
-  function connectToFigma2(port = 3055) {
-    if (ws && ws.readyState === import_ws.default.OPEN) {
-      logger2.info("Already connected to Figma");
-      return;
-    }
-    const wsUrl = serverUrl2 === "localhost" ? `${wsUrlBase}:${port}` : wsUrlBase;
-    logger2.info(`Connecting to Figma socket server at ${wsUrl}...`);
-    ws = new import_ws.default(wsUrl);
-    ws.on("open", () => {
-      logger2.info("Connected to Figma socket server");
-    });
-    ws.on("message", (data) => {
-      try {
-        const json = JSON.parse(data);
-        const myResponse = json.message;
-        logger2.debug(`Received message: ${JSON.stringify(myResponse)}`);
-        logger2.log("myResponse" + JSON.stringify(myResponse));
-        if (myResponse.id && pendingRequests.has(myResponse.id) && myResponse.result) {
-          const request = pendingRequests.get(myResponse.id);
-          clearTimeout(request.timeout);
-          if (myResponse.error) {
-            logger2.error(`Error from Figma: ${myResponse.error}`);
-            request.reject(new Error(myResponse.error));
-          } else if (myResponse.result) {
-            request.resolve(myResponse.result);
-          }
-          pendingRequests.delete(myResponse.id);
-        } else {
-          logger2.info(`Received broadcast message: ${JSON.stringify(myResponse)}`);
-        }
-      } catch (error) {
-        logger2.error(
-          `Error parsing message: ${error instanceof Error ? error.message : String(error)}`
-        );
-      }
-    });
-    ws.on("error", (error) => {
-      logger2.error(`Socket error: ${error}`);
-    });
-    ws.on("close", () => {
-      logger2.info("Disconnected from Figma socket server");
-      ws = null;
-      for (const [id, request] of pendingRequests.entries()) {
-        clearTimeout(request.timeout);
-        request.reject(new Error("Connection closed"));
-        pendingRequests.delete(id);
-      }
-      logger2.info("Attempting to reconnect in 2 seconds...");
-      setTimeout(() => connectToFigma2(port), 2e3);
-    });
-  }
-  function sendCommandToFigma2(command, params = {}) {
-    return new Promise((resolve, reject) => {
-      if (!ws || ws.readyState !== import_ws.default.OPEN) {
-        connectToFigma2();
-        reject(new Error("Not connected to Figma. Attempting to connect..."));
-        return;
-      }
-      const id = (0, import_crypto.randomUUID)();
-      const request = {
-        id,
-        type: "message",
-        message: {
-          id,
-          command,
-          params: {
-            ...params
-          }
-        }
-      };
-      const timeout = setTimeout(() => {
-        if (pendingRequests.has(id)) {
-          pendingRequests.delete(id);
-          logger2.error(`Request ${id} to Figma timed out after 30 seconds`);
-          reject(new Error("Request to Figma timed out"));
-        }
-      }, 3e4);
-      pendingRequests.set(id, { resolve, reject, timeout });
-      logger2.info(`Sending command to Figma: ${command}`);
-      logger2.debug(`Request details: ${JSON.stringify(request)}`);
-      ws.send(JSON.stringify(request));
-    });
-  }
-  return {
-    connectToFigma: connectToFigma2,
-    sendCommandToFigma: sendCommandToFigma2
-  };
-}
-
-// src/server.ts
+var import_zod = require("zod");
 var logger = {
   info: (message) => process.stderr.write(`[INFO] ${message}
 `),
@@ -133,30 +39,16 @@ var logger = {
   log: (message) => process.stderr.write(`[LOG] ${message}
 `)
 };
-var server = new import_mcp.McpServer(
-  {
-    name: "@liner-fe/figma-mcp",
-    version: "1.0.0"
-  },
-  {
-    capabilities: {
-      logging: logger,
-      resources: {
-        subscribe: true,
-        listChanged: true
-      }
-    }
-  }
-);
+var ws = null;
+var pendingRequests = /* @__PURE__ */ new Map();
+var server = new import_mcp.McpServer({
+  name: "@liner-fe/figma-mcp",
+  version: "1.0.0"
+});
 var args = process.argv.slice(2);
 var serverArg = args.find((arg) => arg.startsWith("--server="));
 var serverUrl = serverArg ? serverArg.split("=")[1] : "localhost";
 var WS_URL = serverUrl === "localhost" ? `ws://${serverUrl}` : `wss://${serverUrl}`;
-var { connectToFigma, sendCommandToFigma } = createFigmaClient({
-  logger,
-  serverUrl,
-  wsUrlBase: WS_URL
-});
 server.tool(
   "get_document_info",
   "Get detailed information about the current Figma document",
@@ -184,12 +76,10 @@ server.tool(
     }
   }
 );
-server.registerTool(
+server.tool(
   "get_selection",
-  {
-    description: "Get information about the current selection in Figma",
-    inputSchema: {}
-  },
+  "Get information about the current selection in Figma",
+  {},
   async () => {
     try {
       const result = await sendCommandToFigma("get_selection");
@@ -197,7 +87,7 @@ server.registerTool(
         content: [
           {
             type: "text",
-            text: JSON.stringify(result, null, 2)
+            text: JSON.stringify(result)
           }
         ]
       };
@@ -213,6 +103,183 @@ server.registerTool(
     }
   }
 );
+server.tool(
+  "get_node_info",
+  "Get detailed information about a specific node in Figma",
+  {
+    nodeId: import_zod.z.string().describe("The ID of the node to get information about")
+  },
+  async ({ nodeId }) => {
+    try {
+      const result = await sendCommandToFigma("get_node_info", { nodeId });
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result)
+          }
+        ]
+      };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Error getting node info: ${error instanceof Error ? error.message : String(error)}`
+          }
+        ]
+      };
+    }
+  }
+);
+server.prompt("connection_troubleshooting", "Help users troubleshoot connection issues", () => {
+  return {
+    messages: [
+      {
+        role: "assistant",
+        content: {
+          type: "text",
+          text: `When users report connection issues, ask them to check:
+
+1. Figma Plugin Connection:
+  - Did you click the "Connect" button in the Figma plugin?
+  - Is the Figma plugin running and showing a connected status?
+  - Try refreshing the plugin or restarting it if needed
+
+2. MCP Connection in Cursor:
+  - Go to Cursor Settings/Preferences
+  - Check if the MCP server connection is properly configured(green light)
+  - Verify the MCP server is running and connected
+  - Look for any connection error messages in the settings
+
+If both are properly connected and issues persist, try:
+- Restarting both the Figma plugin and Cursor
+- Checking if the WebSocket connection is blocked by firewall
+- Verifying the correct server URL and port configuration`
+        }
+      }
+    ],
+    description: "Troubleshooting guide for connection issues between Figma plugin and MCP server"
+  };
+});
+server.prompt("data_analysis_strategy", "Best practices for analyzing Figma design data", () => {
+  return {
+    messages: [
+      {
+        role: "assistant",
+        content: {
+          type: "text",
+          text: `When analyzing Figma design data, follow these strategies 
+            
+            1. Data Extraction Workflow:
+             - Use get_selection() to focus on specific areas of interest
+             - Use get_document_info() when connection is enabled
+
+            2. Component Analysis:
+            - Identify reusable components vs one-off elements
+            - Look for design system patterns (colors, typography, spacing)
+            - Note component variants and their properties
+            - Extract design tokens (colors, fonts, spacing values)
+
+            3. Layout Analysis:
+            - Analyze auto-layout settings and constraints
+            - Document spacing patterns and grid systems
+            - Identify responsive design patterns
+            - Note alignment and positioning strategies
+
+
+            `
+        }
+      }
+    ],
+    description: "Best practices for working with Figma designs"
+  };
+});
+function connectToFigma(port = 3055) {
+  if (ws && ws.readyState === import_ws.default.OPEN) {
+    logger.info("Already connected to Figma");
+    return;
+  }
+  const wsUrl = serverUrl === "localhost" ? `${WS_URL}:${port}` : WS_URL;
+  logger.info(`Connecting to Figma socket server at ${wsUrl}...`);
+  ws = new import_ws.default(wsUrl);
+  ws.on("open", () => {
+    logger.info("Connected to Figma socket server");
+  });
+  ws.on("message", (data) => {
+    try {
+      const json = JSON.parse(data);
+      const myResponse = json.message;
+      logger.debug(`Received message: ${JSON.stringify(myResponse)}`);
+      logger.log("myResponse" + JSON.stringify(myResponse));
+      if (myResponse.id && pendingRequests.has(myResponse.id) && myResponse.result) {
+        const request = pendingRequests.get(myResponse.id);
+        clearTimeout(request.timeout);
+        if (myResponse.error) {
+          logger.error(`Error from Figma: ${myResponse.error}`);
+          request.reject(new Error(myResponse.error));
+        } else {
+          if (myResponse.result) {
+            request.resolve(myResponse.result);
+          }
+        }
+        pendingRequests.delete(myResponse.id);
+      } else {
+        logger.info(`Received broadcast message: ${JSON.stringify(myResponse)}`);
+      }
+    } catch (error) {
+      logger.error(
+        `Error parsing message: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  });
+  ws.on("error", (error) => {
+    logger.error(`Socket error: ${error}`);
+  });
+  ws.on("close", () => {
+    logger.info("Disconnected from Figma socket server");
+    ws = null;
+    for (const [id, request] of pendingRequests.entries()) {
+      clearTimeout(request.timeout);
+      request.reject(new Error("Connection closed"));
+      pendingRequests.delete(id);
+    }
+    logger.info("Attempting to reconnect in 2 seconds...");
+    setTimeout(() => connectToFigma(port), 2e3);
+  });
+}
+function sendCommandToFigma(command, params = {}) {
+  return new Promise((resolve, reject) => {
+    if (!ws || ws.readyState !== import_ws.default.OPEN) {
+      connectToFigma();
+      reject(new Error("Not connected to Figma. Attempting to connect..."));
+      return;
+    }
+    const id = (0, import_crypto.randomUUID)();
+    const request = {
+      id,
+      type: "message",
+      message: {
+        id,
+        command,
+        params: {
+          ...params
+        }
+      }
+    };
+    const timeout = setTimeout(() => {
+      if (pendingRequests.has(id)) {
+        pendingRequests.delete(id);
+        logger.error(`Request ${id} to Figma timed out after 30 seconds`);
+        reject(new Error("Request to Figma timed out"));
+      }
+    }, 3e4);
+    pendingRequests.set(id, { resolve, reject, timeout });
+    logger.info(`Sending command to Figma: ${command}`);
+    logger.debug(`Request details: ${JSON.stringify(request)}`);
+    ws.send(JSON.stringify(request));
+  });
+}
 async function main() {
   try {
     connectToFigma();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liner-fe/figma-mcp",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "type": "module",
   "bin": "dist/server/server.cjs",
   "files": [