figma-mcp-server 0.0.0-alpha.1 → 0.1.0

package/tools/figma/figma-api/get-team-projects.js

@@ -0,0 +1,66 @@
+/**
+ * Function to get projects associated with a specific team in Figma.
+ *
+ * @param {Object} args - Arguments for the request.
+ * @param {string} args.team_id - The ID of the team whose projects are to be retrieved.
+ * @returns {Promise<Object>} - The list of projects associated with the team.
+ */
+const executeFunction = async ({ team_id }) => {
+  const baseUrl = 'https://api.figma.com/v1';
+  const token = process.env.FIGMA_API_KEY;
+  try {
+    // Construct the URL for the request
+    const url = `${baseUrl}/teams/${team_id}/projects`;
+
+    // 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) {
+    console.error('Error retrieving team projects:', error);
+    return { error: 'An error occurred while retrieving team projects.' };
+  }
+};
+
+/**
+ * Tool configuration for getting team projects in Figma.
+ * @type {Object}
+ */
+const apiTool = {
+  function: executeFunction,
+  definition: {
+    type: 'function',
+    function: {
+      name: 'get_team_projects',
+      description: 'Retrieve projects associated with a specific team in Figma.',
+      parameters: {
+        type: 'object',
+        properties: {
+          team_id: {
+            type: 'string',
+            description: 'The ID of the team whose projects are to be retrieved.'
+          }
+        },
+        required: ['team_id']
+      }
+    }
+  }
+};
+
+export { apiTool };

package/tools/figma/figma-api/post-a-new-comment.js

@@ -0,0 +1,89 @@
+/**
+ * Function to post a new comment on a Figma file.
+ *
+ * @param {Object} args - Arguments for the comment.
+ * @param {string} args.file_key - The unique identifier of the file to which the comment should be added.
+ * @param {string} args.node_id - The node ID where the comment is to be placed.
+ * @param {string} args.message - The message content of the comment.
+ * @returns {Promise<Object>} - The response from the Figma API after posting the comment.
+ */
+const executeFunction = async ({ file_key, node_id, message }) => {
+  const baseUrl = 'https://api.figma.com/v1';
+  const token = process.env.FIGMA_API_KEY;
+
+  try {
+    // Construct the URL for the API request
+    const url = `${baseUrl}/files/${file_key}/comments`;
+
+    // Prepare the request body
+    const body = JSON.stringify({
+      message: message,
+      client_meta: {
+        x: 0,
+        y: 0,
+        node_id: node_id
+      }
+    });
+
+    // Set up headers for the request
+    const headers = {
+      'X-Figma-Token': token,
+      'Content-Type': 'application/json'
+    };
+
+    // Perform the fetch request
+    const response = await fetch(url, {
+      method: 'POST',
+      headers: headers,
+      body: body
+    });
+
+    // 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) {
+    console.error('Error posting comment:', error);
+    return { error: 'An error occurred while posting the comment.' };
+  }
+};
+
+/**
+ * Tool configuration for posting a new comment on a Figma file.
+ * @type {Object}
+ */
+const apiTool = {
+  function: executeFunction,
+  definition: {
+    type: 'function',
+    function: {
+      name: 'post_new_comment',
+      description: 'Post a new comment on a Figma file.',
+      parameters: {
+        type: 'object',
+        properties: {
+          file_key: {
+            type: 'string',
+            description: 'The unique identifier of the file to which the comment should be added.'
+          },
+          node_id: {
+            type: 'string',
+            description: 'The node ID where the comment is to be placed.'
+          },
+          message: {
+            type: 'string',
+            description: 'The message content of the comment.'
+          }
+        },
+        required: ['file_key', 'node_id', 'message']
+      }
+    }
+  }
+};
+
+export { apiTool };

package/tools/figma/figma-api/post-dev-resource.js

@@ -0,0 +1,93 @@
+/**
+ * Function to post a new development resource to Figma.
+ *
+ * @param {Object} args - Arguments for the new development resource.
+ * @param {string} args.name - The name of the resource.
+ * @param {string} args.url - The URL of the resource.
+ * @param {string} args.file_key - The file key of the resource.
+ * @param {string} args.node_id - The node ID of the resource.
+ * @returns {Promise<Object>} - The result of the resource creation.
+ */
+const executeFunction = async ({ name, url, file_key, node_id }) => {
+  const baseUrl = 'https://api.figma.com/v1';
+  const token = process.env.FIGMA_API_KEY;
+  
+  try {
+    // Construct the request body
+    const body = JSON.stringify({
+      dev_resources: [
+        {
+          name,
+          url,
+          file_key,
+          node_id
+        }
+      ]
+    });
+
+    // Set up headers for the request
+    const headers = {
+      'X-Figma-Token': token,
+      'Content-Type': 'application/json'
+    };
+
+    // Perform the fetch request
+    const response = await fetch(`${baseUrl}/dev_resources`, {
+      method: 'POST',
+      headers,
+      body
+    });
+
+    // 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) {
+    console.error('Error posting development resource:', error);
+    return { error: 'An error occurred while posting the development resource.' };
+  }
+};
+
+/**
+ * Tool configuration for posting a new development resource to Figma.
+ * @type {Object}
+ */
+const apiTool = {
+  function: executeFunction,
+  definition: {
+    type: 'function',
+    function: {
+      name: 'post_dev_resource',
+      description: 'Post a new development resource to Figma.',
+      parameters: {
+        type: 'object',
+        properties: {
+          name: {
+            type: 'string',
+            description: 'The name of the resource.'
+          },
+          url: {
+            type: 'string',
+            description: 'The URL of the resource.'
+          },
+          file_key: {
+            type: 'string',
+            description: 'The file key of the resource.'
+          },
+          node_id: {
+            type: 'string',
+            description: 'The node ID of the resource.'
+          }
+        },
+        required: ['name', 'url', 'file_key', 'node_id']
+      }
+    }
+  }
+};
+
+export { apiTool };

package/tools/figma/figma-api/reply-to-comment.js

@@ -0,0 +1,84 @@
+/**
+ * Function to reply to a comment on a Figma file.
+ *
+ * @param {Object} args - Arguments for the reply.
+ * @param {string} args.message - The message for the new comment.
+ * @param {string} args.comment_id - The identifier of the comment to which the reply is being made.
+ * @param {string} args.file_key - The key of the Figma file.
+ * @returns {Promise<Object>} - The result of the reply operation.
+ */
+const executeFunction = async ({ message, comment_id, file_key }) => {
+  const baseUrl = 'https://api.figma.com/v1';
+  const token = process.env.FIGMA_API_KEY;
+  try {
+    // Construct the URL for the API request
+    const url = `${baseUrl}/files/${file_key}/comments`;
+
+    // Set up headers for the request
+    const headers = {
+      'X-Figma-Token': token,
+      'Content-Type': 'application/json'
+    };
+
+    // Prepare the body of the request
+    const body = JSON.stringify({
+      message,
+      comment_id
+    });
+
+    // Perform the fetch request
+    const response = await fetch(url, {
+      method: 'POST',
+      headers,
+      body
+    });
+
+    // 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) {
+    console.error('Error replying to comment:', error);
+    return { error: 'An error occurred while replying to the comment.' };
+  }
+};
+
+/**
+ * Tool configuration for replying to comments on Figma.
+ * @type {Object}
+ */
+const apiTool = {
+  function: executeFunction,
+  definition: {
+    type: 'function',
+    function: {
+      name: 'reply_to_comment',
+      description: 'Reply to a comment on a Figma file.',
+      parameters: {
+        type: 'object',
+        properties: {
+          message: {
+            type: 'string',
+            description: 'The message for the new comment.'
+          },
+          comment_id: {
+            type: 'string',
+            description: 'The identifier of the comment to which the reply is being made.'
+          },
+          file_key: {
+            type: 'string',
+            description: 'The key of the Figma file.'
+          }
+        },
+        required: ['message', 'comment_id', 'file_key']
+      }
+    }
+  }
+};
+
+export { apiTool };

package/tools/paths.js

@@ -0,0 +1,19 @@
+export const toolPaths = [
+  'figma/figma-api/get-all-webhooks-for-team.js',
+  'figma/figma-api/add-webhook.js',
+  'figma/figma-api/delete-webhook.js',
+  'figma/figma-api/get-library-analytics.js',
+  'figma/figma-api/get-dev-resources.js',
+  'figma/figma-api/get-design.js',
+  'figma/figma-api/get-actions-analytics.js',
+  'figma/figma-api/get-image-node.js',
+  'figma/figma-api/get-team-projects.js',
+  'figma/figma-api/get-project-files.js',
+  'figma/figma-api/get-file-comments.js',
+  'figma/figma-api/post-dev-resource.js',
+  'figma/figma-api/get-images.js',
+  'figma/figma-api/create-variable-collection.js',
+  'figma/figma-api/get-design-node.js',
+  'figma/figma-api/post-a-new-comment.js',
+  'figma/figma-api/reply-to-comment.js'
+];