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

   npm install

2. Set Up Environment (Optional - for custom images)

   cp .env.example .env
   # Edit .env with Nano-banana API key (optional)

3. Build & Test

   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

• Constitution Audit Report

• Handoff Documentation

Made with ❤️ for Dad Joke enthusiasts everywhere! 🎪