Provides surgical precision for generating, debugging, and optimizing high-performance animations using the GreenSock Animation Platform, including support for core methods and plugins like ScrollTrigger and SplitText.
Supports the generation of project boilerplate and integration patterns for using GSAP within Next.js applications, including plugin registration and environment-specific setups.
Generates production-ready GSAP implementations for React, utilizing specialized hooks like useGSAP and ensuring proper lifecycle management and memory cleanup.
Enables complex SVG animations by leveraging GSAP's specialized plugins such as MorphSVG and DrawSVG for path manipulation and drawing effects.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Ultimate GSAP Master MCP ServerMake these cards fade in and stagger as I scroll down the page."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
β‘ Ultimate GSAP Master MCP Server
The Ultimate GSAP Master MCP Server is a high-performance Model Context Protocol (MCP) implementation that grants AI models (like Claude) "surgical precision" over the GreenSock Animation Platform (GSAP).
It transforms natural language animation requests into production-ready, 60fps-optimized code. Whether you need a complex scroll-triggered sequence, character-by-character text reveals, or physics-based Draggable interfaces, this server provides the expert-level knowledge and implementation logic required.
β¨ Features
π§ Advanced Intent Analysis: Understands complex natural language requests (e.g., "Make these cards fade in one by one with a slight bounce when they hit the middle of the screen").
π Production-Ready Code: Generates code with GPU acceleration (
force3D), memory management (clearProps), and proper framework lifecycle handling (ReactuseGSAP, cleanup, etc.).π Complete API Database: Deep knowledge of every core method, easing function, and plugin (ScrollTrigger, SplitText, MorphSVG, DrawSVG, etc.).
π§ Performance Optimization: Automatically refactors laggy animations into high-performance 60fps sequences.
π οΈ Expert Debugging: Analyzes code snippets for layout thrashing, missing plugin registrations, or logic errors.
π All Plugins Included: Knowledge base updated for the GSAP era where SplitText, MorphSVG, and DrawSVG are now free.
π Tools Included
Tool | Description |
| The flagship tool. Converts any animation idea into fully functional GSAP code. |
| Provides deep technical documentation and examples for any GSAP method or plugin. |
| Generates boilerplate for React, Next.js, Vue, or Vanilla, including plugin registration. |
| Identifies and fixes bugs, performance bottlenecks, and logic errors. |
| Refactors existing GSAP code to ensure 60fps smoothness and GPU acceleration. |
| Generates battle-tested patterns like Hero sequences, loading screens, and scroll systems. |
π Installation & Setup
Since this package is published as @vinhnguyen/gsap-mcp, you can use npx to run it without manual installation.
1. Claude Desktop Configuration
Open your Claude Desktop configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
2. Add the Server
Add the following entry to the mcpServers section:
3. Restart Claude
Restart the Claude Desktop application, and you will see a β‘ icon indicating the GSAP Master tools are ready to use.
π Usage Examples
1. Natural Language Creation
User: "I want a hero section where the title letters pop up randomly, and then the subtitle slides in from the left once the title is finished."
AI (using Will generate a gsap.timeline() using SplitText for the characters, applying a back.out ease and a staggered random start time, followed by the subtitle animation.
2. Performance Refactoring
User: "My scroll animation is laggy on mobile. Here is the code: [code snippet animating
AI (using Will refactor the code to use x and y (transforms), add force3D: true, and implement ScrollTrigger.batch for better performance.
3. Setup Generation
User: "Set up a new Next.js project with ScrollTrigger and SplitText."
AI (using Will provide the terminal commands for installation, the gsap.registerPlugin boilerplate, and a useGSAP wrapper for your components.
π Performance Standards
Every piece of code generated by this server adheres to the following standards:
GPU Acceleration: Uses
x,y,scale, androtationinstead of layout properties (top,width,height).Memory Management: Includes
clearPropsand proper cleanup in framework hooks.Reduced Motion: Respects
prefers-reduced-motionmedia queries.Efficiency: Uses GSAP's internal ticker and optimized batching for scroll events.
π License
MIT
Created by Vinh Nguyen - Powered by GSAP Surgical Precision. β‘