extract-svg-assets

Extract SVG assets from Figma files by analyzing the SDL structure and downloading resources using specified file keys and node IDs.

Instructions

分析figma SDL中的结构，并调用download-svg-assets工具下载Figma文件中使用的SVG资源

Input Schema

TableJSON Schema

Name	Required	Description	Default
`fileKey`	Yes	The key of the Figma file to fetch, often found in a provided URL like figma.com/(file\|design)/<fileKey>/...
`nodeId`	No	The ID of the node to fetch, often found as URL parameter node-id=<nodeId>, always use if provided

Implementation Reference

src/services/utility/index.ts:152-186 (handler)

The main handler function for the 'extract-svg-assets' tool. It fetches the Figma DSL (YAML) for the given fileKey and optional nodeId, then constructs an XML prompt using the imported extractSVGAssetsPrompt and the DSL, returning it as text content.

execute: async ({
  fileKey,
  nodeId,
}, {
  session,
}: {
  session: any
}) => {
  try {
    const yamlResult = await this.figmaToolsCore.figmaToCode({
      fileKey,
      nodeId: nodeId || '',
    })

    const prompt: string = `
      <xml>
        <prompt>${extractSVGAssetsPrompt}</prompt>
        <Figma-DSL>${yamlResult}</Figma-DSL>
      </xml>
    `

    return {
      content: [
        { type: 'text', text: prompt },
      ],
    }
  } catch (error) {
    const message = error instanceof Error ? error.message : JSON.stringify(error)
    Logger.error(`Error fetching file ${fileKey}:`, message)
    return {
      isError: true,
      content: [{ type: 'text', text: `Error fetching file: ${message}` }],
    }
  }
},

src/services/utility/index.ts:139-151 (schema)

Zod schema defining the input parameters for the tool: required fileKey (Figma file key) and optional nodeId (node ID).

parameters: z.object({
  fileKey: z
    .string()
    .describe(
      'The key of the Figma file to fetch, often found in a provided URL like figma.com/(file|design)/<fileKey>/...',
    ),
  nodeId: z
    .string()
    .optional()
    .describe(
      'The ID of the node to fetch, often found as URL parameter node-id=<nodeId>, always use if provided',
    ),
}),

src/services/utility/index.ts:135-188 (registration)

The private method that registers the 'extract-svg-assets' tool on the MCP server using server.addTool().

private extractSVGAssets(): void {
  this.server.addTool({
    name: 'extract-svg-assets',
    description: '分析figma SDL中的结构，并调用download-svg-assets工具下载Figma文件中使用的SVG资源',
    parameters: z.object({
      fileKey: z
        .string()
        .describe(
          'The key of the Figma file to fetch, often found in a provided URL like figma.com/(file|design)/<fileKey>/...',
        ),
      nodeId: z
        .string()
        .optional()
        .describe(
          'The ID of the node to fetch, often found as URL parameter node-id=<nodeId>, always use if provided',
        ),
    }),
    execute: async ({
      fileKey,
      nodeId,
    }, {
      session,
    }: {
      session: any
    }) => {
      try {
        const yamlResult = await this.figmaToolsCore.figmaToCode({
          fileKey,
          nodeId: nodeId || '',
        })

        const prompt: string = `
          <xml>
            <prompt>${extractSVGAssetsPrompt}</prompt>
            <Figma-DSL>${yamlResult}</Figma-DSL>
          </xml>
        `

        return {
          content: [
            { type: 'text', text: prompt },
          ],
        }
      } catch (error) {
        const message = error instanceof Error ? error.message : JSON.stringify(error)
        Logger.error(`Error fetching file ${fileKey}:`, message)
        return {
          isError: true,
          content: [{ type: 'text', text: `Error fetching file: ${message}` }],
        }
      }
    },
  })
}

src/services/utility/index.ts:34-34 (registration)
Call to register the extract-svg-assets tool within the public registerTools() method of UtilityTools class.
```
this.extractSVGAssets()
```
src/services/utility/index.ts:12-12 (helper)
Import of the prompt template XML file used within the tool handler to instruct on extracting SVG assets.
```
import extractSVGAssetsPrompt from './prompt/extract-svg-assets.xml'
```

feuse-mcp