After Effects Motion Control Panel (MCP)

A robust solution for fixing and improving the After Effects Motion Control Panel system, ensuring reliable command processing between web UI and After Effects.

🚀 Features

Real-time command monitoring and processing
WebSocket-based status updates
AI-powered command processing
Comprehensive logging and error handling
Permission management for Windows systems
Direct After Effects integration

Related MCP server: Blender MCP Server

📋 Prerequisites

Python 3.8 or higher
After Effects CC or later
Windows 10 or later
Administrator access (for initial setup)

🛠️ Installation

Clone this repository:

git clone https://github.com/yourusername/after-effects-mcp.git cd after-effects-mcp

Create and activate a virtual environment:

python -m venv venv .\venv\Scripts\activate

Install dependencies:

pip install -r requirements.txt

🚀 Quick Start

Run the permissions fix script as administrator:

.\fix_permissions.bat

Start the server:

.\start_server.bat

In After Effects:
- Go to File > Scripts > Run Script File...
- Select after_effects_script/ae_command_fix.jsx

📁 Project Structure

after-effects-mcp/ ├── after_effects_script/ # After Effects JSX scripts ├── server/ # Python server code ├── learning_data/ # AI training data ├── requirements.txt # Python dependencies ├── fix_permissions.bat # Windows permission setup ├── start_server.bat # Server launcher └── README.md # This file

🔧 Usage

Sending Commands

Commands can be sent through:

Web UI interface
Direct command file creation
AI-powered natural language processing

Command format:

{ "action": "create_text_layer", "params": { "text": "Example Text", "fontSize": 72, "color": "#00AAFF" } }

Monitoring

Use the MCP Status Monitor for real-time command tracking
Check logs in the After Effects script panel
Monitor server status through WebSocket connection

🔍 Troubleshooting

Common Issues

"No command file found" in After Effects:
- Verify C:\ae_temp directory exists
- Check file permissions
- Ensure server is running
Web UI shows success but nothing happens:
- Check server status
- Verify WebSocket connection
- Check After Effects script panel logs
Permission errors:
- Run fix_permissions.bat as administrator
- Verify C:\ae_temp directory permissions
- Check user account access rights

🤝 Contributing

Fork the repository
Create a feature branch
Commit your changes
Push to the branch
Create a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Adobe After Effects team for the scripting API
Contributors and testers
Open source community

📞 Support

For support:

Check the troubleshooting guide
Review the logs
Open an issue with:
- Detailed error description
- Steps to reproduce
- System information
- Log files

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

After Effects Motion Control Panel