figma-mcp-server 0.1.1 → 2.0.0

package/tools/figma/figma-api/get-a-published-component-set-by-key.js

@@ -1,35 +1,23 @@
-/**
- * Function to get metadata for a published component set by its key from Figma.
- *
- * @param {Object} args - Arguments for the request.
- * @param {string} args.key - The key of the component set to retrieve.
- * @returns {Promise<Object>} - The metadata for the component set.
- */
 const executeFunction = async ({ key }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Construct the URL with the component set key
     const url = `${baseUrl}/v1/component_sets/${key}`;
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url, {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -38,10 +26,6 @@ const executeFunction = async ({ key }) => {
   }
 };
 
-/**
- * Tool configuration for retrieving component set metadata from Figma.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/get-a-published-library-by-id.js

@@ -1,35 +1,23 @@
-/**
- * Function to get metadata for a published library in Figma by its ID.
- *
- * @param {Object} args - Arguments for the library retrieval.
- * @param {string} args.library_id - The ID of the library to retrieve.
- * @returns {Promise<Object>} - The metadata of the published library.
- */
 const executeFunction = async ({ library_id }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Construct the URL with the library ID
     const url = `${baseUrl}/v1/libraries/${library_id}`;
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url, {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -38,10 +26,6 @@ const executeFunction = async ({ library_id }) => {
   }
 };
 
-/**
- * Tool configuration for retrieving library metadata in Figma.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/get-a-published-style-by-key.js

@@ -1,35 +1,23 @@
-/**
- * Function to get a published style from Figma by its key.
- *
- * @param {Object} args - Arguments for the request.
- * @param {string} args.key - The key of the published style to retrieve.
- * @returns {Promise<Object>} - The metadata for the published style.
- */
 const executeFunction = async ({ key }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Construct the URL with the style key
     const url = `${baseUrl}/v1/styles/${key}`;
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url, {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -38,10 +26,6 @@ const executeFunction = async ({ key }) => {
   }
 };
 
-/**
- * Tool configuration for getting a published style from Figma.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/get-current-user.js

@@ -1,30 +1,21 @@
-/**
- * Function to get the current user information from Figma.
- *
- * @returns {Promise<Object>} - The information about the user associated with the access token.
- */
 const executeFunction = async () => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(`${baseUrl}/v1/me`, {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -33,10 +24,6 @@ const executeFunction = async () => {
   }
 };
 
-/**
- * Tool configuration for getting the current user information from Figma.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/get-file-nodes.js

@@ -1,39 +1,26 @@
-/**
- * Function to get specific nodes from a Figma file.
- *
- * @param {Object} args - Arguments for the request.
- * @param {string} args.file_key - The key of the Figma file.
- * @param {string} [args.node_id] - The ID of the node to retrieve. If not provided, all nodes will be returned.
- * @returns {Promise<Object>} - The result of the node retrieval.
- */
 const executeFunction = async ({ file_key, node_id }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Construct the URL
     const url = new URL(`${baseUrl}/v1/files/${file_key}/nodes`);
     if (node_id) {
       url.searchParams.append('ids', node_id);
     }
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url.toString(), {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -42,10 +29,6 @@ const executeFunction = async ({ file_key, node_id }) => {
   }
 };
 
-/**
- * Tool configuration for getting nodes from a Figma file.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/get-file-version-history.js

@@ -1,35 +1,23 @@
-/**
- * Function to get the version history of a Figma file.
- *
- * @param {Object} args - Arguments for the request.
- * @param {string} args.file_key - The key of the Figma file for which to retrieve version history.
- * @returns {Promise<Object>} - The version history of the specified Figma file.
- */
 const executeFunction = async ({ file_key }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Construct the URL for the request
     const url = `${baseUrl}/v1/files/${file_key}/versions`;
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url, {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -38,10 +26,6 @@ const executeFunction = async ({ file_key }) => {
   }
 };
 
-/**
- * Tool configuration for retrieving the version history of a Figma file.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/get-file.js

@@ -1,35 +1,23 @@
-/**
- * Function to get the full document tree of a Figma file.
- *
- * @param {Object} args - Arguments for the file retrieval.
- * @param {string} args.file_key - The key of the Figma file to retrieve.
- * @returns {Promise<Object>} - The result of the file retrieval.
- */
 const executeFunction = async ({ file_key }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Construct the URL for the request
     const url = `${baseUrl}/v1/files/${file_key}`;
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url, {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -38,10 +26,6 @@ const executeFunction = async ({ file_key }) => {
   }
 };
 
-/**
- * Tool configuration for retrieving a Figma file.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/get-image-fills.js

@@ -1,39 +1,26 @@
-/**
- * Function to get image fills from a Figma file.
- *
- * @param {Object} args - Arguments for the image fills request.
- * @param {string} args.file_key - The key of the Figma file.
- * @param {string} [args.node_id] - The ID of the specific node to retrieve images for (optional).
- * @returns {Promise<Object>} - The URLs for rendered images of specific nodes.
- */
 const executeFunction = async ({ file_key, node_id }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Construct the URL with the file key and optional node ID
     const url = new URL(`${baseUrl}/v1/images/${file_key}`);
     if (node_id) {
       url.searchParams.append('ids', node_id);
     }
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url.toString(), {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -42,10 +29,6 @@ const executeFunction = async ({ file_key, node_id }) => {
   }
 };
 
-/**
- * Tool configuration for getting image fills from a Figma file.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/get-library-action-analytics.js

@@ -1,35 +1,23 @@
-/**
- * Function to get library action analytics from Figma.
- *
- * @param {Object} args - Arguments for the analytics request.
- * @param {string} args.library_file_key - The key of the library file for which to retrieve action analytics.
- * @returns {Promise<Object>} - The result of the library action analytics request.
- */
 const executeFunction = async ({ library_file_key }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Construct the URL for the request
     const url = `${baseUrl}/v1/analytics/libraries/${library_file_key}/actions`;
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url, {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -38,10 +26,6 @@ const executeFunction = async ({ library_file_key }) => {
   }
 };
 
-/**
- * Tool configuration for getting library action analytics from Figma.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/get-library-usage-analytics.js

@@ -1,35 +1,23 @@
-/**
- * Function to get library usage analytics from Figma.
- *
- * @param {Object} args - Arguments for the analytics request.
- * @param {string} args.library_file_key - The key of the library file for which to retrieve usage analytics.
- * @returns {Promise<Object>} - The result of the library usage analytics request.
- */
 const executeFunction = async ({ library_file_key }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Construct the URL for the request
     const url = `${baseUrl}/v1/analytics/libraries/${library_file_key}/usages`;
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url, {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -38,10 +26,6 @@ const executeFunction = async ({ library_file_key }) => {
   }
 };
 
-/**
- * Tool configuration for getting library usage analytics from Figma.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/list-comments-on-a-file.js

@@ -1,35 +1,23 @@
-/**
- * Function to list comments on a Figma file.
- *
- * @param {Object} args - Arguments for the comment listing.
- * @param {string} args.file_key - The key of the Figma file to list comments from.
- * @returns {Promise<Array>} - A promise that resolves to an array of comments.
- */
 const executeFunction = async ({ file_key }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Construct the URL for the API request
     const url = `${baseUrl}/v1/files/${file_key}/comments`;
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url, {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data.comments || [];
   } catch (error) {
@@ -38,10 +26,6 @@ const executeFunction = async ({ file_key }) => {
   }
 };
 
-/**
- * Tool configuration for listing comments on a Figma file.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/list-component-sets-in-a-file.js

@@ -1,36 +1,24 @@
-/**
- * Function to list component sets in a specific Figma file.
- *
- * @param {Object} args - Arguments for the request.
- * @param {string} args.file_key - The key of the Figma file to retrieve component sets from.
- * @returns {Promise<Object>} - The response containing the list of component sets.
- */
 const executeFunction = async ({ file_key }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
 
   try {
-    // Construct the URL for the request
     const url = `${baseUrl}/v1/files/${file_key}/component_sets`;
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url, {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -39,10 +27,6 @@ const executeFunction = async ({ file_key }) => {
   }
 };
 
-/**
- * Tool configuration for listing component sets in a Figma file.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/list-components-in-a-file.js

@@ -1,35 +1,23 @@
-/**
- * Function to list components in a specific Figma file.
- *
- * @param {Object} args - Arguments for the request.
- * @param {string} args.file_key - The key of the Figma file to retrieve components from.
- * @returns {Promise<Object>} - The list of components in the specified Figma file.
- */
 const executeFunction = async ({ file_key }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Construct the URL for the request
     const url = `${baseUrl}/v1/files/${file_key}/components`;
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url, {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -38,10 +26,6 @@ const executeFunction = async ({ file_key }) => {
   }
 };
 
-/**
- * Tool configuration for listing components in a Figma file.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {

package/tools/figma/figma-api/list-dev-resources-for-a-file.js

@@ -1,35 +1,23 @@
-/**
- * Function to list development resources for a specific Figma file.
- *
- * @param {Object} args - Arguments for the request.
- * @param {string} args.file_key - The key of the Figma file to retrieve development resources for.
- * @returns {Promise<Object>} - The result of the development resources request.
- */
 const executeFunction = async ({ file_key }) => {
   const baseUrl = 'https://api.figma.com';
   const token = process.env.FIGMA_API_KEY;
   try {
-    // Construct the URL for the request
     const url = `${baseUrl}/v1/files/${file_key}/dev_resources`;
 
-    // Set up headers for the request
     const headers = {
       'X-Figma-Token': token
     };
 
-    // Perform the fetch request
     const response = await fetch(url, {
       method: 'GET',
       headers
     });
 
-    // Check if the response was successful
     if (!response.ok) {
       const errorData = await response.json();
       throw new Error(errorData);
     }
 
-    // Parse and return the response data
     const data = await response.json();
     return data;
   } catch (error) {
@@ -38,10 +26,6 @@ const executeFunction = async ({ file_key }) => {
   }
 };
 
-/**
- * Tool configuration for listing development resources for a Figma file.
- * @type {Object}
- */
 const apiTool = {
   function: executeFunction,
   definition: {