preangelleo/animagent-mcp-server

AnimAgent MCP Server

🚀 One-Click Installation

macOS/Linux:

git clone https://github.com/preangelleo/animagent-mcp-server.git && cd animagent-mcp-server && ./install.sh

Windows:

git clone https://github.com/preangelleo/animagent-mcp-server.git && cd animagent-mcp-server && install.bat

That's it! The installer automatically:

• ✅ Checks Node.js installation
• ✅ Installs all dependencies
• ✅ Guides you through credential setup
• ✅ Configures Claude Desktop for you
• ✅ Verifies the connection

🌟 What is AnimAgent?

AnimAgent is the world's first MCP server for AI-generated story animations. Transform your ideas into professional animated videos through natural conversation with Claude Desktop - no video editing skills required!

✨ Key Features

• 🎭 13 Story Types: Fairytales, Sci-Fi, Educational, Romance, Adventure, and more
• 🌍 12 Languages: English, Chinese, Spanish, French, Hindi, Arabic, and more
• 🎨 18 Art Styles: Ghibli, Pixar, Watercolor, Oil Painting, Comic, and more
• ⏱️ Flexible Duration: 5 to 60 minutes
• 📱 Multiple Formats: Landscape (16:9), Portrait (9:16), Square (1:1)
• 🚀 Cloud-Based: No GPU required, all processing in the cloud
• 💬 Natural Language: Just describe what you want in plain English

🎯 Quick Start Guide

Step 1: Get Your Credentials (2 minutes)

1. Register at app.sumatman.ai
2. Login with your email
3. Copy your User ID from the Welcome page
4. Remember your email address

Step 2: Install the Client (1 minute)

Run the one-click installer above, or manually:

# Clone and install
git clone https://github.com/preangelleo/animagent-mcp-server.git
cd animagent-mcp-server
npm install

# Configure credentials
cp .env.example .env
# Edit .env with your User ID and Email

# Setup Claude Desktop
npm run setup

Step 3: Start Creating! (Instant)

In Claude Desktop, simply type:

"Create a 10-minute fairytale about a brave mouse discovering magical cheese"

💬 Usage Examples

Basic Creation

"Create a children's story about friendship"

With Full Customization

"Create a 15-minute sci-fi adventure in Japanese anime style, 
suitable for teenagers, with Chinese narration"

With Advanced Options

"Create an educational story with subtitles and zoom effects enabled"

Task Management

"Show me the status of my animation task"
"Edit task web_123_abc to change duration to 20 minutes"
"Repeat my last task but with a different story"

🛠️ Available Commands

🎬 Advanced Video Options (v2.2.0)

🎨 Customization Options

🔧 Advanced Configuration

Manual Claude Desktop Setup

If automatic setup doesn't work, manually edit Claude's config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "animagent": {
      "command": "node",
      "args": ["/path/to/animagent-mcp-server/src/index.js"],
      "env": {
        "ANIMAGENT_USER_ID": "your-user-id",
        "ANIMAGENT_USER_EMAIL": "your-email@example.com"
      }
    }
  }
}

Environment Variables

🚨 Troubleshooting

Common Issues & Solutions

✅ "Edit task web_123_abc to change duration"
❌ "Edit my task to change duration"

💰 Pricing

• Credit System: 50 credits per minute of video
• Free Trial: 100 credits on signup
• Packages: From $1 (10 credits) to $500 (7,000 credits)
• View Balance: app.sumatman.ai/credits

🏗️ Technology Stack

AI-Powered Components

• 📝 Story Creation: Google Gemini Pro 2.5 transforms your ideas into compelling narratives and structured storylines with image description for each scene
• 🎤 Voice Acting: Volcano Engine for authentic Chinese voice generation, ElevenLabs for international voices and subtitle force alignment
• 🎨 Visual Generation: Advanced Flux Kontext Max and QWen models ensure consistent, beautiful scene generation with proper text rendering
• 🎬 Video Processing: CloudBurst Fargate enables parallel video processing - fast rendering regardless of the number of scenes

🏗️ Architecture

graph LR
    A[Claude Desktop] -->|MCP Protocol| B[AnimAgent Client]
    B -->|HTTPS/JSON-RPC| C[AnimAgent Server]
    C -->|Process| D[AI Pipeline]
    D --> E[Gemini Pro 2.5 Story]
    D --> F[Flux Kontext Max/QWen Images]
    D --> G[Volcano Engine/ElevenLabs Voice]
    D --> H[CloudBurst Fargate Video]
    H -->|Final Video| I[User Dashboard]

🤝 Contributing

We welcome contributions! Please see our for details.

# Fork and clone
git clone https://github.com/YOUR_USERNAME/animagent-mcp-server.git

# Create feature branch
git checkout -b feature/amazing-feature

# Commit changes
git commit -m 'Add amazing feature'

# Push and create PR
git push origin feature/amazing-feature

📄 License

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

🆘 Support

• Website: app.sumatman.ai
• GitHub Issues: Report a bug
• Email: support@sumatman.ai

🙏 Acknowledgments

• Built with Model Context Protocol by Anthropic
• Powered by Sumatman AI
• Special thanks to all our early adopters and contributors