figma-mcp-server 2.0.1 → 2.1.1

package/tools/figma/figma-api/{get-library-usage-analytics.js → get-library-usage-analytics.ts}

@@ -1,6 +1,7 @@
-const executeFunction = async ({ library_file_key }) => {
+import { ApiTool, getFigmaToken } from "../../../lib/tools.ts";
+const executeFunction = async ({ library_file_key }: any) => {
   const baseUrl = 'https://api.figma.com';
-  const token = process.env.FIGMA_API_KEY;
+  const token = getFigmaToken();
   try {
     const url = `${baseUrl}/v1/analytics/libraries/${library_file_key}/usages`;
 
@@ -14,19 +15,16 @@ const executeFunction = async ({ library_file_key }) => {
     });
 
     if (!response.ok) {
-      const errorData = await response.json();
-      throw new Error(errorData);
+      const errorData = await response.json() as any;
+      throw new Error(`Figma API Error: ${errorData.message || response.statusText}`);
     }
 
     const data = await response.json();
     return data;
-  } catch (error) {
-    console.error('Error retrieving library usage analytics:', error);
-    return { error: 'An error occurred while retrieving library usage analytics.' };
-  }
+  } catch (error) { throw error; }
 };
 
-const apiTool = {
+const apiTool: ApiTool = {
   function: executeFunction,
   definition: {
     type: 'function',

package/tools/figma/figma-api/{list-comments-on-a-file.js → list-comments-on-a-file.ts}

@@ -1,6 +1,7 @@
-const executeFunction = async ({ file_key }) => {
+import { ApiTool, getFigmaToken } from "../../../lib/tools.ts";
+const executeFunction = async ({ file_key }: any) => {
   const baseUrl = 'https://api.figma.com';
-  const token = process.env.FIGMA_API_KEY;
+  const token = getFigmaToken();
   try {
     const url = `${baseUrl}/v1/files/${file_key}/comments`;
 
@@ -14,19 +15,16 @@ const executeFunction = async ({ file_key }) => {
     });
 
     if (!response.ok) {
-      const errorData = await response.json();
-      throw new Error(errorData);
+      const errorData = await response.json() as any;
+      throw new Error(`Figma API Error: ${errorData.message || response.statusText}`);
     }
 
     const data = await response.json();
-    return data.comments || [];
-  } catch (error) {
-    console.error('Error listing comments on the Figma file:', error);
-    return { error: 'An error occurred while listing comments.' };
-  }
+    return (data as any).comments || [];
+  } catch (error) { throw error; }
 };
 
-const apiTool = {
+const apiTool: ApiTool = {
   function: executeFunction,
   definition: {
     type: 'function',

package/tools/figma/figma-api/{list-component-sets-in-a-file.js → list-component-sets-in-a-file.ts}

@@ -1,6 +1,7 @@
-const executeFunction = async ({ file_key }) => {
+import { ApiTool, getFigmaToken } from "../../../lib/tools.ts";
+const executeFunction = async ({ file_key }: any) => {
   const baseUrl = 'https://api.figma.com';
-  const token = process.env.FIGMA_API_KEY;
+  const token = getFigmaToken();
 
   try {
     const url = `${baseUrl}/v1/files/${file_key}/component_sets`;
@@ -15,19 +16,16 @@ const executeFunction = async ({ file_key }) => {
     });
 
     if (!response.ok) {
-      const errorData = await response.json();
-      throw new Error(errorData);
+      const errorData = await response.json() as any;
+      throw new Error(`Figma API Error: ${errorData.message || response.statusText}`);
     }
 
     const data = await response.json();
     return data;
-  } catch (error) {
-    console.error('Error listing component sets:', error);
-    return { error: 'An error occurred while listing component sets.' };
-  }
+  } catch (error) { throw error; }
 };
 
-const apiTool = {
+const apiTool: ApiTool = {
   function: executeFunction,
   definition: {
     type: 'function',

package/tools/figma/figma-api/{list-components-in-a-file.js → list-components-in-a-file.ts}

@@ -1,6 +1,7 @@
-const executeFunction = async ({ file_key }) => {
+import { ApiTool, getFigmaToken } from "../../../lib/tools.ts";
+const executeFunction = async ({ file_key }: any) => {
   const baseUrl = 'https://api.figma.com';
-  const token = process.env.FIGMA_API_KEY;
+  const token = getFigmaToken();
   try {
     const url = `${baseUrl}/v1/files/${file_key}/components`;
 
@@ -14,19 +15,16 @@ const executeFunction = async ({ file_key }) => {
     });
 
     if (!response.ok) {
-      const errorData = await response.json();
-      throw new Error(errorData);
+      const errorData = await response.json() as any;
+      throw new Error(`Figma API Error: ${errorData.message || response.statusText}`);
     }
 
     const data = await response.json();
     return data;
-  } catch (error) {
-    console.error('Error listing components in file:', error);
-    return { error: 'An error occurred while listing components in the file.' };
-  }
+  } catch (error) { throw error; }
 };
 
-const apiTool = {
+const apiTool: ApiTool = {
   function: executeFunction,
   definition: {
     type: 'function',

package/tools/figma/figma-api/{list-dev-resources-for-a-file.js → list-dev-resources-for-a-file.ts}

@@ -1,6 +1,7 @@
-const executeFunction = async ({ file_key }) => {
+import { ApiTool, getFigmaToken } from "../../../lib/tools.ts";
+const executeFunction = async ({ file_key }: any) => {
   const baseUrl = 'https://api.figma.com';
-  const token = process.env.FIGMA_API_KEY;
+  const token = getFigmaToken();
   try {
     const url = `${baseUrl}/v1/files/${file_key}/dev_resources`;
 
@@ -14,19 +15,16 @@ const executeFunction = async ({ file_key }) => {
     });
 
     if (!response.ok) {
-      const errorData = await response.json();
-      throw new Error(errorData);
+      const errorData = await response.json() as any;
+      throw new Error(`Figma API Error: ${errorData.message || response.statusText}`);
     }
 
     const data = await response.json();
     return data;
-  } catch (error) {
-    console.error('Error listing development resources:', error);
-    return { error: 'An error occurred while listing development resources.' };
-  }
+  } catch (error) { throw error; }
 };
 
-const apiTool = {
+const apiTool: ApiTool = {
   function: executeFunction,
   definition: {
     type: 'function',

package/tools/figma/figma-api/{list-files-in-a-project.js → list-files-in-a-project.ts}

@@ -1,6 +1,7 @@
-const executeFunction = async ({ project_id }) => {
+import { ApiTool, getFigmaToken } from "../../../lib/tools.ts";
+const executeFunction = async ({ project_id }: any) => {
   const baseUrl = 'https://api.figma.com';
-  const token = process.env.FIGMA_API_KEY;
+  const token = getFigmaToken();
 
   try {
     const url = `${baseUrl}/v1/projects/${project_id}/files`;
@@ -15,19 +16,16 @@ const executeFunction = async ({ project_id }) => {
     });
 
     if (!response.ok) {
-      const errorData = await response.json();
-      throw new Error(errorData);
+      const errorData = await response.json() as any;
+      throw new Error(`Figma API Error: ${errorData.message || response.statusText}`);
     }
 
     const data = await response.json();
     return data;
-  } catch (error) {
-    console.error('Error listing files in project:', error);
-    return { error: 'An error occurred while listing files in the project.' };
-  }
+  } catch (error) { throw error; }
 };
 
-const apiTool = {
+const apiTool: ApiTool = {
   function: executeFunction,
   definition: {
     type: 'function',

package/tools/figma/figma-api/{list-projects-in-a-team.js → list-projects-in-a-team.ts}

@@ -1,6 +1,7 @@
-const executeFunction = async ({ team_id }) => {
+import { ApiTool, getFigmaToken } from "../../../lib/tools.ts";
+const executeFunction = async ({ team_id }: any) => {
   const baseUrl = 'https://api.figma.com';
-  const token = process.env.FIGMA_API_KEY;
+  const token = getFigmaToken();
   try {
     const url = `${baseUrl}/v1/teams/${team_id}/projects`;
 
@@ -14,19 +15,16 @@ const executeFunction = async ({ team_id }) => {
     });
 
     if (!response.ok) {
-      const errorData = await response.json();
-      throw new Error(errorData);
+      const errorData = await response.json() as any;
+      throw new Error(`Figma API Error: ${errorData.message || response.statusText}`);
     }
 
     const data = await response.json();
     return data;
-  } catch (error) {
-    console.error('Error listing projects:', error);
-    return { error: 'An error occurred while listing projects.' };
-  }
+  } catch (error) { throw error; }
 };
 
-const apiTool = {
+const apiTool: ApiTool = {
   function: executeFunction,
   definition: {
     type: 'function',

package/tools/figma/figma-api/{list-published-libraries.js → list-published-libraries.ts}

@@ -1,6 +1,7 @@
+import { ApiTool, getFigmaToken } from "../../../lib/tools.ts";
 const executeFunction = async () => {
   const baseUrl = 'https://api.figma.com/v1/libraries/published';
-  const token = process.env.FIGMA_API_KEY;
+  const token = getFigmaToken();
   try {
     const headers = {
       'X-Figma-Token': token
@@ -12,19 +13,16 @@ const executeFunction = async () => {
     });
 
     if (!response.ok) {
-      const errorData = await response.json();
-      throw new Error(errorData);
+      const errorData = await response.json() as any;
+      throw new Error(`Figma API Error: ${errorData.message || response.statusText}`);
     }
 
     const data = await response.json();
     return data;
-  } catch (error) {
-    console.error('Error listing published libraries:', error);
-    return { error: 'An error occurred while listing published libraries.' };
-  }
+  } catch (error) { throw error; }
 };
 
-const apiTool = {
+const apiTool: ApiTool = {
   function: executeFunction,
   definition: {
     type: 'function',

package/tools/figma/figma-api/{list-styles-in-a-file.js → list-styles-in-a-file.ts}

@@ -1,6 +1,7 @@
-const executeFunction = async ({ file_key }) => {
+import { ApiTool, getFigmaToken } from "../../../lib/tools.ts";
+const executeFunction = async ({ file_key }: any) => {
   const baseUrl = 'https://api.figma.com';
-  const token = process.env.FIGMA_API_KEY;
+  const token = getFigmaToken();
 
   try {
     const url = `${baseUrl}/v1/files/${file_key}/styles`;
@@ -15,19 +16,16 @@ const executeFunction = async ({ file_key }) => {
     });
 
     if (!response.ok) {
-      const errorData = await response.json();
-      throw new Error(errorData);
+      const errorData = await response.json() as any;
+      throw new Error(`Figma API Error: ${errorData.message || response.statusText}`);
     }
 
     const data = await response.json();
     return data;
-  } catch (error) {
-    console.error('Error listing styles in the Figma file:', error);
-    return { error: 'An error occurred while listing styles in the Figma file.' };
-  }
+  } catch (error) { throw error; }
 };
 
-const apiTool = {
+const apiTool: ApiTool = {
   function: executeFunction,
   definition: {
     type: 'function',

package/tools/figma/figma-api/{list-variables-for-a-file.js → list-variables-for-a-file.ts}

@@ -1,6 +1,7 @@
-const executeFunction = async ({ file_key }) => {
+import { ApiTool, getFigmaToken } from "../../../lib/tools.ts";
+const executeFunction = async ({ file_key }: any) => {
   const baseUrl = 'https://api.figma.com';
-  const token = process.env.FIGMA_API_KEY;
+  const token = getFigmaToken();
   try {
     const url = `${baseUrl}/v1/files/${file_key}/variables`;
 
@@ -14,19 +15,16 @@ const executeFunction = async ({ file_key }) => {
     });
 
     if (!response.ok) {
-      const errorData = await response.json();
-      throw new Error(errorData);
+      const errorData = await response.json() as any;
+      throw new Error(`Figma API Error: ${errorData.message || response.statusText}`);
     }
 
     const data = await response.json();
     return data;
-  } catch (error) {
-    console.error('Error listing variables for the file:', error);
-    return { error: 'An error occurred while listing variables for the file.' };
-  }
+  } catch (error) { throw error; }
 };
 
-const apiTool = {
+const apiTool: ApiTool = {
   function: executeFunction,
   definition: {
     type: 'function',

package/tools/figma/figma-api/{post-a-comment-to-a-file.js → post-a-comment-to-a-file.ts}

@@ -1,6 +1,7 @@
-const executeFunction = async ({ file_key, message, client_meta = {} }) => {
+import { ApiTool, getFigmaToken } from "../../../lib/tools.ts";
+const executeFunction = async ({ file_key, message, client_meta = {} }: any) => {
   const baseUrl = 'https://api.figma.com';
-  const token = process.env.FIGMA_API_KEY;
+  const token = getFigmaToken();
 
   try {
     const url = `${baseUrl}/v1/files/${file_key}/comments`;
@@ -22,19 +23,16 @@ const executeFunction = async ({ file_key, message, client_meta = {} }) => {
     });
 
     if (!response.ok) {
-      const errorData = await response.json();
-      throw new Error(errorData);
+      const errorData = await response.json() as any;
+      throw new Error(`Figma API Error: ${errorData.message || response.statusText}`);
     }
 
     const data = await response.json();
     return data;
-  } catch (error) {
-    console.error('Error posting comment to Figma file:', error);
-    return { error: 'An error occurred while posting the comment.' };
-  }
+  } catch (error) { throw error; }
 };
 
-const apiTool = {
+const apiTool: ApiTool = {
   function: executeFunction,
   definition: {
     type: 'function',

package/tools/paths.ts

@@ -0,0 +1,25 @@
+export const toolPaths = [
+    'figma/figma-api/list-published-libraries.ts',
+    'figma/figma-api/get-a-published-component-by-key.ts',
+    'figma/figma-api/get-file.ts',
+    'figma/figma-api/list-component-sets-in-a-file.ts',
+    'figma/figma-api/list-dev-resources-for-a-file.ts',
+    'figma/figma-api/get-a-published-library-by-id.ts',
+    'figma/figma-api/list-components-in-a-file.ts',
+    'figma/figma-api/get-library-usage-analytics.ts',
+    'figma/figma-api/list-comments-on-a-file.ts',
+    'figma/figma-api/get-image-fills.ts',
+    'figma/figma-api/list-variables-for-a-file.ts',
+    'figma/figma-api/get-file-version-history.ts',
+    'figma/figma-api/list-files-in-a-project.ts',
+    'figma/figma-api/get-library-action-analytics.ts',
+    'figma/figma-api/create-variable-collections-for-a-file.ts',
+    'figma/figma-api/get-file-nodes.ts',
+    'figma/figma-api/get-a-published-style-by-key.ts',
+    'figma/figma-api/get-current-user.ts',
+    'figma/figma-api/create-dev-resources-for-a-file.ts',
+    'figma/figma-api/list-styles-in-a-file.ts',
+    'figma/figma-api/list-projects-in-a-team.ts',
+    'figma/figma-api/get-a-published-component-set-by-key.ts',
+    'figma/figma-api/post-a-comment-to-a-file.ts'
+];

package/tsconfig.json

@@ -0,0 +1,28 @@
+{
+    "compilerOptions": {
+        "lib": [
+            "ESNext"
+        ],
+        "module": "esnext",
+        "target": "esnext",
+        "moduleResolution": "bundler",
+        "moduleDetection": "force",
+        "allowImportingTsExtensions": true,
+        "noEmit": true,
+        "composite": true,
+        "strict": true,
+        "downlevelIteration": true,
+        "skipLibCheck": true,
+        "jsx": "react-jsx",
+        "allowSyntheticDefaultImports": true,
+        "forceConsistentCasingInFileNames": true,
+        "allowJs": true,
+        "types": [
+            "bun-types" // Bun types
+        ]
+    },
+    "include": [
+        "**/*.ts",
+        "**/*.js"
+    ]
+}

package/commands/tools.js

@@ -1,65 +0,0 @@
-import { discoverTools } from "../lib/tools.js";
-
-export function registerToolsCommand(program) {
-  program
-    .command("tools")
-    .description("List all available API tools")
-    .action(async () => {
-      const tools = await discoverTools();
-      if (tools.length === 0) {
-        console.log("No tools found. Tools should be organized as:");
-        console.log("tools/workspace/collection/request.js\n");
-        return;
-      }
-
-      console.log("\nAvailable Tools:\n");
-
-      // Group tools by workspace/collection
-      const groupedTools = tools.reduce((acc, tool) => {
-        // Extract workspace and collection from path
-        const parts = tool.path.split("/");
-        const workspace = parts[1] || "Unknown Workspace";
-        const collection = parts[2] || "Unknown Collection";
-
-        if (!acc[workspace]) acc[workspace] = {};
-        if (!acc[workspace][collection]) acc[workspace][collection] = [];
-
-        acc[workspace][collection].push(tool);
-        return acc;
-      }, {});
-
-      // Print tools in a hierarchical structure
-      for (const [workspace, collections] of Object.entries(groupedTools)) {
-        console.log(`Workspace: ${workspace}`);
-        for (const [collection, tools] of Object.entries(collections)) {
-          console.log(`  Collection: ${collection}`);
-          tools.forEach(
-            ({
-              definition: {
-                function: { name, description, parameters },
-              },
-            }) => {
-              console.log(`    ${name}`);
-              console.log(
-                `      Description: ${description || "No description provided"}`
-              );
-              if (parameters?.properties) {
-                console.log("      Parameters:");
-                Object.entries(parameters.properties).forEach(
-                  ([name, details]) => {
-                    console.log(
-                      `        - ${name}: ${
-                        details.description || "No description"
-                      }`
-                    );
-                  }
-                );
-              }
-              console.log("");
-            }
-          );
-        }
-        console.log("");
-      }
-    });
-}

package/lib/tools.js

@@ -1,12 +0,0 @@
-import { toolPaths } from "../tools/paths.js";
-
-export async function discoverTools() {
-  const toolPromises = toolPaths.map(async (file) => {
-    const module = await import(`../tools/${file}`);
-    return {
-      ...module.apiTool,
-      path: file,
-    };
-  });
-  return Promise.all(toolPromises);
-}