claude-composer-mcp

rkm097git/claude-composer-mcp

3.1

If you are the rightful owner of claude-composer-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Claude Composer MCP is a server that democratizes interactive content creation for non-technical educators using natural language.

Claude Composer MCP

A Model Context Protocol (MCP) server that democratizes interactive content creation for EuConquisto Composer, enabling non-technical educators to create student-centered, engaging digital experiences through natural language. This tool significantly enhances Composer's appeal by making advanced interactive content accessible to all users, regardless of technical expertise.

🎯 Empowering Non-Technical Educators

Making Composer Irresistibly Accessible - Transform any educator into an interactive content creator:

  • 🚀 Zero Technical Barriers - Natural language input creates professional interactive content
  • 🎮 Student-Centered Design - Content designed for engagement and active learning
  • 🔥 4+ Interactive Widgets Mandatory - quiz-1, hotspots-1, flashcards-2, sorted-activity-1, timeline-1
  • 💡 Instant Digital Experiences - From idea to published interactive lesson in minutes
  • 📱 Competitive Edge for Composer - Unique AI-powered content creation no other platform offers
  • ✅ 2-Phase Workflow - Student experience design → Teacher facilitation guide
  • ✅ Reliable Publishing - Robust widget ID generation and validation
  • ✅ BNCC Compliant - Full Brazilian education standards integration

🚀 Composer's Game-Changing Advantage

Why This Makes Composer Unbeatable:

  • 🎯 No-Code Interactive Content - Educators describe their vision, AI creates professional digital experiences
  • 🏆 Market Differentiation - First platform to offer AI-powered interactive lesson generation
  • 💼 Broader User Base - Appeals to non-technical educators who previously couldn't create interactive content
  • ⚡ Speed to Market - Lessons that took hours now take minutes
  • 🎨 Professional Quality - AI ensures consistent, engaging, pedagogically sound content

How It Works

This MCP server orchestrates intelligent content creation:

  • InstructionalDesignerAgent: Converts natural language into engaging learning experiences
  • Claude Desktop: High-reasoning content design and validation
  • Gemini API: Autonomous widget mapping with interactive-first prioritization
  • EuConquisto Composer: Direct publishing to the platform

Setup

  1. Install dependencies:

    npm install

  2. Configure environment:

    cp .env.example .env
# Edit .env with your API keys

  3. Build the project:

    npm run build

  4. Run in development:

    npm run dev

Environment Variables

  • GEMINI_API_KEY: Your Google Gemini API key
  • LOG_LEVEL: Logging level (error, warn, info, debug)
  • COMPOSER_API_BASE_URL: EuConquisto Composer API base URL
  • COMPOSER_API_KEY: EuConquisto Composer API key

🚀 Quick Start Example

Transform Any Lesson Idea into Interactive Content

For Non-Technical Educators: Simply describe your lesson vision in natural language - the AI handles all the technical complexity!

import { InstructionalDesignerAgent } from './src/agents/claude/InstructionalDesignerAgent.js';

const designer = new InstructionalDesignerAgent();

// Phase 1: Student learning experience
const request = {
  gradeLevel: '5º ano',
  subject: 'Matemática', 
  topic: 'Frações',
  duration: '50 minutos'
};

const experiencePrompt = designer.generateLearningExperiencePrompt(request);
// Returns student-centered prompt focusing on interactive widgets

// Parse the learning experience
const experience = designer.parseLearningExperience(claudeResponse);
// Validates 4+ interactive widgets, student-centered objectives

// Phase 2: Teacher facilitation guide  
const teacherPrompt = designer.generateTeacherGuidePrompt(experience);
// Generates practical facilitation instructions

Interactive Widget Requirements

Every learning experience must include minimum 4 interactive widgets:

// Highly Interactive (Priority 1)
'quiz-1'           // Knowledge checks with immediate feedback
'hotspots-1'       // Visual exploration and discovery
'flashcards-2'     // Memory reinforcement and practice  
'sorted-activity-1' // Categorization and sequencing
'timeline-1'       // Chronological understanding

// Moderately Interactive (Priority 2)
'accordion', 'tabs', 'images-gallery'

// Supportive (Priority 3)  
'head-1', 'image-and-text'

// Minimal Use (Priority 4)
'text' // Only for essential context

🏛️ Effortless for Educators, Powerful for Composer

Simple Interface, Sophisticated Results - Designed to make Composer the most user-friendly platform:

// Single agent for student-centered content creation
import { InstructionalDesignerAgent } from './agents/claude/InstructionalDesignerAgent.js';

// Clear, focused workflow
const designer = new InstructionalDesignerAgent();
const experience = await createLearningExperience(request);

Development

  • npm run dev: Run in development mode with hot reload
  • npm run build: Build TypeScript to JavaScript
  • npm test: Run comprehensive test suite
  • npm run test:basic: Run basic functionality tests
  • npm run lint: Run ESLint

🏗️ Architecture

Democratizing Interactive Content Creation

graph TD
    A[ContentRequest] --> B[InstructionalDesignerAgent]
    B --> C[Student Learning Experience]
    C --> D[4+ Interactive Widgets]
    D --> E[WidgetMapper - Interactive Priority]
    E --> F[FormatAgent - ID Generation Fix]
    F --> G[ComposerAPI - Publishing]
    
    C --> H[Teacher Facilitation Guide]
    H --> I[Support Materials]

Core Components - Making Composer Accessible to Everyone

  • InstructionalDesignerAgent: 🎯 Converts educator ideas into professional interactive experiences
  • WidgetMapperAgent: 🎮 Automatically selects optimal interactive elements
  • FormatAgent: 🔧 Ensures flawless publishing to Composer platform
  • ComposerAPI: 📤 Seamless integration with EuConquisto ecosystem
  • Orchestrator: 🎼 Coordinates the entire creation process invisibly

2-Phase Workflow - Effortless Content Creation

  1. Phase 1: Student Experience (AI-Generated from Natural Language)

    • Automatic interactive learning design
    • Built-in engagement hooks and feedback loops
    • Guaranteed minimum 4 interactive widgets
    • Adaptive challenge progression

  2. Phase 2: Teacher Guide (AI-Generated Support Materials)

    • Ready-to-use facilitation strategies
    • Clear intervention guidelines
    • Assessment rubrics and guidance
    • Differentiation recommendations

Result: Non-technical educators get professional-quality interactive lessons with comprehensive teaching support - all from a simple conversation with AI!

License

MIT