Figma MCP Server with Chunking

Instructions

Implementation Reference

• src/index.ts:356-368 (handler)

  MCP tool handler for 'get_file_versions' that validates the file_key argument, calls the figmaClient.getFileVersions method, and returns the result as a JSON-formatted text content block.

  case 'get_file_versions': {
    const args = request.params.arguments as unknown as FileKeyArgs;
    if (!args.file_key) {
      throw new McpError(ErrorCode.InvalidParams, 'file_key is required');
    }
    console.debug('[MCP Debug] Fetching file versions', {
      fileKey: args.file_key,
    });
    const data = await this.figmaClient.getFileVersions(args.file_key);
    return {
      content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
    };
  }

• src/index.ts:164-177 (registration)

  Registration of the 'get_file_versions' tool in the ListTools response, including name, description, and input schema.

  {
    name: 'get_file_versions',
    description: 'Get version history of a Figma file',
    inputSchema: {
      type: 'object',
      properties: {
        file_key: {
          type: 'string',
          description: 'Figma file key'
        }
      },
      required: ['file_key']
    }
  },

• src/client.ts:327-342 (helper)

  Implementation of getFileVersions in ChunkedFigmaClient that makes the Figma API request to retrieve file version history and returns the response data, with memory limit check.

  async getFileVersions(fileKey: string) {
    try {
      console.debug('[MCP Debug] Getting versions for file:', fileKey);
      const response = await this.client.get(`/files/${fileKey}/versions`);
      
      if (this.nodeProcessor.hasReachedLimit()) {
        console.debug('[MCP Debug] Memory limit reached while processing versions');
        throw new Error('Memory limit exceeded while processing versions');
      }
  
      return response.data;
    } catch (error) {
      console.error('[MCP Error] Failed to get file versions:', error);
      throw error;
    }
  }