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

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

# 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