MCP Puppet Pipeline

# MCP Puppet Pipeline Model Context Protocol (MCP) puppet automation pipeline for browser automation and AI-driven workflows. ## Overview A comprehensive MCP server implementation that provides tools and workflows for automated browser control, file operations, and AI agent coordination. Includes file hygiene management, conversation continuity, and QNAP integration. ## Features - **MCP Server**: Full MCP protocol implementation - **Browser Automation**: Puppet-based web automation - **File Hygiene**: Automated file organization and cleanup - **Conversation Continuity**: Agent state management across sessions - **QNAP Integration**: Network storage integration - **Auto-Startup**: System initialization and startup automation - **Logging System**: Comprehensive logging and monitoring - **Handoff System**: Agent-to-agent task handoffs ## Tech Stack - TypeScript/Node.js - Model Context Protocol (MCP) - Puppeteer for browser automation - QNAP network storage integration ## Getting Started ### Prerequisites - Node.js (v18+ recommended) - QNAP NAS (for storage integration) - Access to MCP-compatible AI systems ### Installation ```bash npm install ``` ### Configuration 1. Configure QNAP connection in `qnap-config.json` 2. Set up logging preferences in `logging-config.json` 3. Configure MCP server in `mcp-server-config.js` 4. Review and customize startup scripts ### Usage ```bash # Run setup ./run_mcp_setup.sh # Start MCP system (Windows) START-MCP-SYSTEM.bat # Run pre-initialization node run-pre-init.js # Start server npm start ``` ## Project Structure - `src/` - Source code - `server.ts` - Main MCP server - `agents/` - Agent implementations - `integrations/` - External service integrations - `tools/` - MCP tools - `logging/` - Logging system - `workflows/` - Workflow definitions - `handoffs/` - Agent handoff sessions - `inventory/` - File and resource inventory - `public/` - Public assets ## Key Components ### File Hygiene Agent Automated file organization, cleanup, and management system with registry tracking. ### Conversation Continuity Agent Maintains context and state across agent sessions and handoffs. ### Affogato Integration Character pipeline and asset management through Affogato API. ### Auto Handoff System Automated task routing and handoffs between agents. ## Documentation See individual markdown files for detailed documentation: - `AUTO-STARTUP-SETUP.md` - Startup automation - `FILE_HYGIENE_MCP_GUIDE.md` - File hygiene system - `REMEDIATION_CHECKLIST.md` - System remediation ## License MIT