MCP Puppet Pipeline

# Claude Puppet Automation

Automated browser control and video processing system powered by Claude AI and MCP tools.

## Overview
A production automation system that integrates Claude AI with browser puppet controls for automated video processing, frame extraction, and pipeline execution. Designed for hands-free multimedia production workflows.

## Features
- **Claude AI Controller**: Automated decision-making and task execution
- **Browser Puppet Integration**: Automated browser control for web-based tools
- **Video Processing**: Frame extraction and video manipulation
- **MCP Server Integration**: Tools for AI-driven automation
- **Pipeline Automation**: Configurable multi-step workflows
- **One-Click Execution**: Batch files for instant deployment

## Tech Stack
- JavaScript/Node.js
- Claude AI API
- Puppeteer for browser automation
- FFmpeg for video processing
- MCP (Model Context Protocol) tools

## Getting Started

### Prerequisites
- Node.js (v18+ recommended)
- FFmpeg installed
- Claude API access
- Browser (Chrome/Chromium)

### Installation
```bash
npm install
```

### Quick Start
**Windows:**
```bash
# Click-to-run automation
CLICK_TO_RUN.bat

# Execute full automation
EXECUTE_NOW.bat

# Start automation system
START_AUTOMATION.bat
```

**Manual:**
```bash
# Launch main pipeline
node LAUNCH.js

# Run full automation
node FULL_AUTOMATION.js

# Execute specific automation
node RUN_AUTOMATION.js
```

### Configuration
Edit `pipeline_config.json` to customize:
- Video processing settings
- Frame extraction parameters
- Automation workflows
- Output destinations

## Project Structure
- `claude_automated/` - Claude controller and automation scripts
  - `CLAUDE_CONTROLLER.js` - Main Claude AI controller
  - `START.js` - Startup script
  - `EXECUTE_NOW.js` - Immediate execution
  - `extract_frame.js` - Frame extraction utilities
- `mcp_tools/` - MCP server integration
  - `mcp_server_integration.js` - MCP server connector
  - `video_processing_tools.js` - Video processing tools
- `pipeline_config.json` - Pipeline configuration
- `SYSTEM_READY.md` - System readiness checklist

## Use Cases
- Automated video frame extraction
- Batch video processing
- Web-based tool automation
- Multimedia production pipelines
- AI-driven content creation workflows

## Documentation
- `SYSTEM_READY.md` - System setup and readiness
- `video_frame_extractor_spec.md` - Frame extraction specifications
- `claude_automated/README.md` - Claude automation details

## License
MIT