# DadJokeVisualizer

🎭 **Dad Joke Visualizer MCP Server** - An AI-powered tool that generates PG-13 Dad Jokes with visualizations and displays them on beautiful web pages.

## 🚀 Features

- **Built-in Dad Jokes**: Curated collection of PG-13 Dad Jokes - no external API needed! 🎭
- **Visual Illustrations**: Generates images using Nano-banana API (optional - has fallback)
- **Beautiful Web Interface**: Modern, responsive web pages to display jokes and images
- **MCP Integration**: Works seamlessly with Cursor's Auto feature
- **Constitution Compliant**: Follows best coding practices and quality standards
- **Zero Dependencies**: No external API keys required for core functionality!

## 📋 Quick Start

1. **Install Dependencies**
   ```bash
   npm install
   ```

2. **Set Up Environment** (Optional - for custom images)
   ```bash
   cp .env.example .env
   # Edit .env with Nano-banana API key (optional)
   ```

3. **Build & Test**
   ```bash
   npm run build
   npm run test
   ```

4. **Configure Cursor**
   Copy `cursor-mcp-config.json` contents to your Cursor MCP settings

## 🎯 Usage

Use prompts in Cursor like:
- "Generate a Dad Joke about programming"
- "Create a Dad Joke visualization"
- "Make a Dad Joke about cats"

## 🔧 Nano-banana API Status

**Note**: Currently experiencing SSL certificate issues with `api.nanobanana.com`. The system gracefully falls back to automatic placeholder images, ensuring full functionality regardless of external API availability.

**Workaround**: The Dad Joke Visualizer is designed to work perfectly with or without external image APIs - enjoy the Dad jokes with stylish placeholder visualizations! 🎭

## 📊 Quality Metrics

- **✅ TypeScript**: 0 errors maintained
- **✅ Constitution Compliance**: 98% quality score
- **✅ Build Success**: Clean compilation
- **✅ Test Coverage**: Comprehensive testing suite

## 📚 Documentation

- [Complete Setup Guide](SETUP_COMPLETE.md)
- [Constitution Audit Report](CONSTITUTION_AUDIT_REPORT.md)
- [Handoff Documentation](HANDOFF_DAD_JOKE_VISUALIZER.md)

---

**Made with ❤️ for Dad Joke enthusiasts everywhere!** 🎪