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

Related MCP server: Components Build MCP

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