Semesters MCP Server

A specialized Model Context Protocol (MCP) server for building trauma-informed, dyslexia-friendly educational software. This server provides AI assistants with specialized tools for creating accessible learning applications that follow evidence-based educational methodologies.

Features

• Dyslexia-Friendly UI Generation: Creates accessible components with OpenDyslexic fonts and high contrast
• Trauma-Informed Content Review: Validates content against trauma-informed principles
• Orton-Gillingham Activity Validation: Ensures activities follow OG methodology
• Multisensory Phoneme Activities: Generates activities using multiple learning modalities
• Code Safety Review: Reviews code for trauma-informed principles
• Stress Detection Protocols: Generates protocols for handling learner stress
• Engagement Activities: Creates intrinsically motivating learning experiences
• Safety Validation: Checks engagement mechanics for potential trauma triggers

Installation

Prerequisites

• Node.js 18+
• npm or yarn
• TypeScript 5.0+

Setup

# Clone the repository
git clone <repository-url>
cd semesters-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

MCP Configuration

To use this server with an MCP client (like Claude Desktop), add the following to your MCP configuration file:

{
  "mcpServers": {
    "semesters-dev": {
      "command": "node",
      "args": ["path/to/semesters-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

Replace path/to/semesters-mcp-server with the actual path to your installation.

Usage

The server runs via stdio and provides 8 specialized tools for educational software development:

1. generate_dyslexia_ui - Generate accessible UI components
2. review_trauma_content - Review content for trauma-informed language
3. validate_og_activity - Validate against Orton-Gillingham principles
4. generate_phoneme_activity - Create multisensory phoneme practice
5. review_code_safety - Review code for trauma-informed principles
6. generate_stress_protocol - Create stress detection/response protocols
7. generate_engagement_activity - Create intrinsically motivating activities
8. validate_engagement_safety - Check engagement mechanics for safety

Development

npm run dev    # Watch mode for development
npm run build  # Build TypeScript to JavaScript
npm start      # Run the built server
npm run clean  # Clean build directory

Testing

The project includes a comprehensive test suite that exercises all available tools:

# Run the test suite
node test-tools.js

The test script will:

• List all available tools
• Test each tool with sample inputs
• Validate responses and error handling
• Provide detailed output for debugging

API Reference

Tool Parameters

generate_dyslexia_ui

• componentType: "button" | "text" | "input" | "card"
• content: String content for the component
• intent: "primary" | "secondary" | "comfort" | "celebration"

review_trauma_content

• content: Text content to review
• context: Optional context where content appears

validate_og_activity

• activity: Activity object to validate
• targetLevel: Target OG level (1-5)

generate_phoneme_activity

• phoneme: Target phoneme to practice
• modalities: Array of "visual" | "auditory" | "kinesthetic" | "tactile"

review_code_safety

• code: Code to review
• language: Programming language

generate_stress_protocol

• triggerType: "behavioral" | "physiological" | "performance"
• severity: "mild" | "moderate" | "high"

generate_engagement_activity

• phoneme: Target phoneme to practice
• theme: "dragons" | "space" | "magic" | "animals" | "adventure" | "mystery"
• stressLevel: "low" | "medium" | "high"
• inputMethods: Array of "touch" | "voice" | "camera" | "microphone" | "bluetooth"

validate_engagement_safety

• mechanic: Engagement mechanic to validate
• context: Context where mechanic would be used

Educational Principles

• Trauma-Informed: No failure states, child agency, positive reinforcement
• Dyslexia-Friendly: OpenDyslexic fonts, high contrast, generous spacing
• Orton-Gillingham: Systematic, multisensory, sequential phonics instruction
• Age-Appropriate: Sophisticated contexts for foundational skills (12+ years)

Technical Details

• Runtime: Node.js with ES modules
• Language: TypeScript 5.0+
• Protocol: Model Context Protocol (MCP) via stdio
• Dependencies: @modelcontextprotocol/sdk
• Architecture: Single-file server with modular tool handlers

Contributing

When contributing to this project, please ensure:

1. All code follows trauma-informed principles
2. UI components are dyslexia-friendly
3. Educational content aligns with Orton-Gillingham methodology
4. Test coverage is maintained for new tools
5. Documentation is updated for API changes

License

MIT License - see package.json for details