🎓 MCP Teacher Grader

Intelligent automated grading system for academic assignments using Model Context Protocol

Transform your grading workflow with AI-powered analysis that provides detailed, consistent feedback while saving hours of manual review time.

✨ Key Features

• 🤖 AI-Powered Analysis: Advanced text processing with OCR support for scanned documents
• 📋 Flexible Rubrics: JSON-based rubric system adaptable to any assignment type
• 📊 Comprehensive Analytics: Class performance insights and individual progress tracking
• 🔍 Multi-Format Support: PDF, DOCX, TXT, and Markdown submissions
• 🎯 Detailed Feedback: Personalized comments with specific improvement suggestions
• ⚡ Batch Processing: Grade entire classes in minutes, not hours
• 🔌 MCP Integration: Works seamlessly with Claude Desktop for enhanced AI assistance

🚀 Quick Start

Install Globally

npm install -g @arnifa/mcp-teacher-grader

Set Up Your First Project

# Create and initialize a grading project
mkdir my-assignment-grading && cd my-assignment-grading
mcp-teacher-grader init

Start Grading

# Place student submissions in submissions/ folder
# Customize your rubric in rubrics/
mcp-teacher-grader grade

That's it! The system will process all submissions and generate detailed feedback.

📖 Documentation

• Installation Guide - Detailed setup instructions
• Contributing Guidelines - How to contribute to the project
• Example Rubrics - Templates for different assignment types

🎯 Perfect For

• Computer Science Courses: Code analysis, algorithm explanations, software design
• Writing Assignments: Essays, reports, research papers
• STEM Subjects: Problem-solving steps, mathematical proofs, lab reports
• Any Subject: Customizable rubrics adapt to your specific needs

🔧 Advanced Usage

Claude Desktop Integration

# Install and configure for use with Claude Desktop
mcp-teacher-grader server

Add to your Claude Desktop config:

{
  "mcpServers": {
    "teacher-grader": {
      "command": "mcp-teacher-grader",
      "args": ["server"]
    }
  }
}

Custom Rubrics

Create specialized rubrics for different assignment types:

{
  "name": "Essay Grading Rubric",
  "totalPoints": 100,
  "questions": [
    {
      "id": "thesis",
      "description": "Thesis Statement Quality",
      "points": 25,
      "criteria": ["Clear position", "Arguable claim", "Proper placement"]
    }
  ]
}

📊 Sample Output

The system generates:

• Individual feedback files with detailed analysis
• Class performance summary with grade distribution
• Question-by-question insights identifying common issues
• Improvement recommendations for both students and instruction

🤝 Contributing

We welcome contributions! This project is designed to help educators worldwide. See CONTRIBUTING.md for guidelines.

📄 License

MIT License - see LICENSE for details.

🔗 Links

• npm Package: @arnifa/mcp-teacher-grader
• GitHub Repository: arnif/mcp-teacher-grader
• Bug Reports: GitHub Issues

Transform your grading process today. Install with npm install -g @arnifa/mcp-teacher-grader and start saving time while improving feedback quality! 🎓