EuConquisto Composer MCP

# Claude Native Implementation - True Content Generation ## 🎯 **The Problem We Solved** Previous "intelligent" modules were actually **template-based systems** that: - Used fixed templates with keyword substitution ("Vamos estudar ${topic}...") - Generated identical widget structures for every lesson - Created poor learning experiences with 90% repeated content - Ignored Claude's sophisticated content generation abilities ## ✅ **The Solution: Claude Native MCP Server** **File**: `/src/claude-native-mcp-server.ts` This implementation: 1. **Lets Claude create the full educational content** naturally 2. **Lets Claude select the best widgets** for each content segment 3. **Maps Claude's choices to Composer format** without interference 4. **Saves to Composer** via browser automation ## 🏗️ **How It Works** ### **New Workflow** 1. **User asks Claude**: "Create a 50-minute photosynthesis lesson for 7th grade" 2. **Claude generates rich content** with appropriate widgets: ```json { "title": "Fotossíntese: A Fábrica de Energia das Plantas", "gradeLevel": "7º ano", "subject": "Ciências", "duration": 50, "widgets": [ { "type": "header", "content": { "category": "Ciências - Biologia", ... }, "order": 1 }, { "type": "text", "content": { "html": "<h2>O que é Fotossíntese?</h2><p>..." }, "order": 2 }, { "type": "video", "content": { "title": "Processo de Fotossíntese Animado", ... }, "order": 3 }, { "type": "flashcards", "content": { "cards": [...] }, "order": 4 }, { "type": "quiz", "content": { "questions": [...] }, "order": 5 } ] } ``` 3. **Claude calls tool**: `save-educational-composition` with the content 4. **Tool maps to Composer format** and saves via browser ### **Available Widgets** - `header` - Lesson header with metadata - `text` - Rich HTML content - `video` - Educational videos - `flashcards` - Interactive memory cards - `quiz` - Assessment questions - `image` - Illustrations and diagrams - `accordion` - Expandable content sections ## 🚀 **Usage Example** ### **Step 1: Start the Server** ```bash cd /Users/ricardokawasaki/Desktop/euconquisto-composer-mcp-poc ./start-claude-native.sh ``` ### **Step 2: Configure in Claude Desktop** Add to MCP settings: ```json { "mcpServers": { "euconquisto-claude-native": { "command": "/Users/ricardokawasaki/Desktop/euconquisto-composer-mcp-poc/start-claude-native.sh" } } } ``` ### **Step 3: Create a Lesson** Ask Claude: > "Create a comprehensive 50-minute lesson about photosynthesis for 7th grade students. Include: > - An engaging introduction explaining what photosynthesis is > - Visual demonstration of the process > - Interactive flashcards for key terms > - A quiz to assess understanding > > Select appropriate widgets for each section and save to Composer." Claude will: 1. Generate sophisticated, topic-specific content 2. Choose the best widget types for each section 3. Call `save-educational-composition` with the complete lesson 4. Display the composition in Composer ## 🔑 **Key Differences** ### **Before (Template-Based)** ```typescript // Fixed template - same for every lesson return `Vamos estudar ${topic} de forma interativa e divertida!...`; ``` ### **After (Claude-Native)** ```typescript // Claude generates unique content for each lesson { "type": "text", "content": { "html": "<h2>A Incrível Jornada da Luz Solar</h2> <p>Imagine que você é um raio de sol viajando...</p>" } } ``` ## 📋 **Tools Available** ### **save-educational-composition** Saves Claude-generated educational content to Composer - Input: Complete lesson structure with widgets - Output: Composition URL in Composer ### **get-available-widgets** Lists all available widget types and their capabilities - Input: None - Output: Widget documentation ## ✨ **Benefits** 1. **No Templates**: Every lesson is unique and topic-appropriate 2. **Claude's Intelligence**: Leverages full NLP and educational expertise 3. **Flexible Widgets**: Claude chooses the best widget for each content type 4. **Rich Content**: Sophisticated explanations, not keyword substitution 5. **True Integration**: Seamless workflow from Claude to Composer ## 🔧 **Technical Details** - **No regex patterns** for topic extraction - **No fixed widget order** - Claude decides - **No template strings** - all content is Claude-generated - **Clean separation** between content generation (Claude) and formatting (MCP) - **Browser automation** handles Composer integration --- **Status**: ✅ Ready for testing **Server**: `/src/claude-native-mcp-server.ts` **Startup**: `./start-claude-native.sh`