# 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