{"_id":"@arnifa/mcp-teacher-grader","_rev":"5-fa1d288fde8e8bdcb5563112e725d169","name":"@arnifa/mcp-teacher-grader","dist-tags":{"latest":"1.3.0"},"versions":{"1.0.0":{"name":"@arnifa/mcp-teacher-grader","version":"1.0.0","keywords":["education","grading","automation","mcp","academic","assessment","rubric","feedback","ai-grading","teacher-tools","model-context-protocol"],"author":{"name":"MCP Teacher Grader Team"},"license":"MIT","_id":"@arnifa/mcp-teacher-grader@1.0.0","maintainers":[{"name":"arnifa","email":"arnifa+1@gmail.com"}],"homepage":"https://github.com/arnif/mcp-teacher-grader#readme","bugs":{"url":"https://github.com/arnif/mcp-teacher-grader/issues"},"bin":{"mcp-teacher-grader":"bin/cli.js"},"dist":{"shasum":"9f25d0a760ce2d6de9d7e42100449d1f2ed7e7ef","tarball":"https://registry.npmjs.org/@arnifa/mcp-teacher-grader/-/mcp-teacher-grader-1.0.0.tgz","fileCount":17,"integrity":"sha512-cU7GplwlOzCf0oaKImxTkdBU6K4FHGtpkWPXvjXmgBjDeQ1kp6eYYEQMPiPg6gPpskuWU+ELq9xUZq4E5jfFdg==","signatures":[{"sig":"MEYCIQD/KNsXuhPAxLBkc3A6d46bK3qEMk/iA4HiCWww90bqjgIhALj3Slh3FGQvqpC65+g84GSml9MokqR8j+eOwgYLBDcN","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":108372},"main":"dist/server.js","type":"module","engines":{"npm":">=10.0.0","node":">=20.10.0"},"gitHead":"f98c500bf3b7370be8b476bb803eebd8da62b6d6","scripts":{"build":"tsc && npm run copy-resources","check":"npx tsc --noEmit","clean":"rm -rf feedback_detailed/* || del /q feedback_detailed\\*","grade":"tsx grade_detailed.ts","setup":"node -e \"console.log('Run setup.bat on Windows or setup.sh on Unix systems')\"","start":"tsx src/server.ts","copy-resources":"cp -r rubrics dist/ || xcopy rubrics dist\\rubrics /E /I","prepublishOnly":"npm run build"},"_npmUser":{"name":"arnifa","email":"arnifa+1@gmail.com"},"repository":{"url":"git+https://github.com/arnif/mcp-teacher-grader.git","type":"git"},"_npmVersion":"10.2.3","description":"Intelligent automated grading system for academic assignments using Model Context Protocol","directories":{},"_nodeVersion":"20.10.0","dependencies":{"zod":"^3.25.76","sharp":"^0.34.3","mammoth":"^1.10.0","pdf2pic":"^3.2.0","pdf-parse":"^1.1.1","pdfjs-dist":"^5.4.149","tesseract.js":"^6.0.1","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","typescript":"^5.9.2","@types/node":"^24.3.1","@types/pdf-parse":"^1.1.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-teacher-grader_1.0.0_1757247648349_0.005995623497978331","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@arnifa/mcp-teacher-grader","version":"1.0.1","keywords":["education","grading","automation","mcp","academic","assessment","rubric","feedback","ai-grading","teacher-tools","model-context-protocol"],"author":{"name":"MCP Teacher Grader Team"},"license":"MIT","_id":"@arnifa/mcp-teacher-grader@1.0.1","maintainers":[{"name":"arnifa","email":"arnifa+1@gmail.com"}],"homepage":"https://github.com/arnif/mcp-teacher-grader#readme","bugs":{"url":"https://github.com/arnif/mcp-teacher-grader/issues"},"bin":{"mcp-teacher-grader":"bin/cli.js"},"dist":{"shasum":"b57401b85c007ca630238633dea60b34c41380d3","tarball":"https://registry.npmjs.org/@arnifa/mcp-teacher-grader/-/mcp-teacher-grader-1.0.1.tgz","fileCount":17,"integrity":"sha512-33bvX2581OK86A2xx9EB65hkWnapgPQbTyvwlyg0gMeRmhY3Yty7qpeDaWY8LWC7n/El19WckZvDypRp/fKHgA==","signatures":[{"sig":"MEYCIQD5CclIIpNlYFU/eEucO0UGS7gujT1QCRODStmcJF/UqAIhAOyDn1Q23IuNHXMC81WeyT0DIagcwVPyl+6Kl33/AfCp","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":110253},"main":"dist/server.js","type":"module","engines":{"npm":">=10.0.0","node":">=20.10.0"},"gitHead":"a2bf3ea6c58935cba0583dbda345aeb96028e24d","scripts":{"build":"tsc && npm run copy-resources","check":"npx tsc --noEmit","clean":"rm -rf feedback_detailed/* || del /q feedback_detailed\\*","grade":"tsx grade_detailed.ts","setup":"node -e \"console.log('Run setup.bat on Windows or setup.sh on Unix systems')\"","start":"tsx src/server.ts","copy-resources":"cp -r rubrics dist/ || xcopy rubrics dist\\rubrics /E /I","prepublishOnly":"npm run build"},"_npmUser":{"name":"arnifa","email":"arnifa+1@gmail.com"},"repository":{"url":"git+https://github.com/arnif/mcp-teacher-grader.git","type":"git"},"_npmVersion":"10.2.3","description":"Intelligent automated grading system for academic assignments using Model Context Protocol","directories":{},"_nodeVersion":"20.10.0","dependencies":{"zod":"^3.25.76","sharp":"^0.34.3","mammoth":"^1.10.0","pdf2pic":"^3.2.0","pdf-parse":"^1.1.1","pdfjs-dist":"^5.4.149","tesseract.js":"^6.0.1","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","typescript":"^5.9.2","@types/node":"^24.3.1","@types/pdf-parse":"^1.1.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-teacher-grader_1.0.1_1757248733006_0.28826119186896637","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@arnifa/mcp-teacher-grader","version":"1.1.0","keywords":["education","grading","automation","mcp","academic","assessment","rubric","feedback","ai-grading","teacher-tools","model-context-protocol"],"author":{"name":"MCP Teacher Grader Team"},"license":"MIT","_id":"@arnifa/mcp-teacher-grader@1.1.0","maintainers":[{"name":"arnifa","email":"arnifa+1@gmail.com"}],"homepage":"https://github.com/arnif/mcp-teacher-grader#readme","bugs":{"url":"https://github.com/arnif/mcp-teacher-grader/issues"},"bin":{"mcp-teacher-grader":"bin/cli.js"},"dist":{"shasum":"6ec858bb7510a4ca03ff3013c6a7f15059c1878e","tarball":"https://registry.npmjs.org/@arnifa/mcp-teacher-grader/-/mcp-teacher-grader-1.1.0.tgz","fileCount":17,"integrity":"sha512-jXs8WCuP9EiMrs5+6NbyKDnx4NmoMxHsPbhHL2wPyNEd3FQvrQKJlZkSM8fvUgoSbJaeRwnEnYeIB4PVhldcXQ==","signatures":[{"sig":"MEYCIQCCtYVSxaeadWzgq4eG7LrWQx0Egx1Zu7MREaTFnfWtbwIhAPs9daKHjKpVWlHPzylc2Bp9OoC5rUBH7avGg8anhpE6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":116572},"main":"dist/server.js","type":"module","engines":{"npm":">=10.0.0","node":">=20.10.0"},"gitHead":"a2bf3ea6c58935cba0583dbda345aeb96028e24d","scripts":{"build":"tsc && npm run copy-resources","check":"npx tsc --noEmit","clean":"rm -rf feedback_detailed/* || del /q feedback_detailed\\*","grade":"tsx grade_detailed.ts","setup":"node -e \"console.log('Run setup.bat on Windows or setup.sh on Unix systems')\"","start":"tsx src/server.ts","copy-resources":"cp -r rubrics dist/ || xcopy rubrics dist\\rubrics /E /I","prepublishOnly":"npm run build"},"_npmUser":{"name":"arnifa","email":"arnifa+1@gmail.com"},"repository":{"url":"git+https://github.com/arnif/mcp-teacher-grader.git","type":"git"},"_npmVersion":"10.2.3","description":"Intelligent automated grading system for academic assignments using Model Context Protocol","directories":{},"_nodeVersion":"20.10.0","dependencies":{"zod":"^3.25.76","sharp":"^0.34.3","mammoth":"^1.10.0","pdf2pic":"^3.2.0","pdf-parse":"^1.1.1","pdfjs-dist":"^5.4.149","tesseract.js":"^6.0.1","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","typescript":"^5.9.2","@types/node":"^24.3.1","@types/pdf-parse":"^1.1.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-teacher-grader_1.1.0_1757252139953_0.08368010209024779","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@arnifa/mcp-teacher-grader","version":"1.2.0","keywords":["education","grading","automation","mcp","academic","assessment","rubric","feedback","ai-grading","teacher-tools","model-context-protocol"],"author":{"name":"MCP Teacher Grader Team"},"license":"MIT","_id":"@arnifa/mcp-teacher-grader@1.2.0","maintainers":[{"name":"arnifa","email":"arnifa+1@gmail.com"}],"homepage":"https://github.com/arnif/mcp-teacher-grader#readme","bugs":{"url":"https://github.com/arnif/mcp-teacher-grader/issues"},"bin":{"mcp-teacher-grader":"bin/cli.js"},"dist":{"shasum":"b2068f4f5d80d0e1196377a1268d8e435378e59f","tarball":"https://registry.npmjs.org/@arnifa/mcp-teacher-grader/-/mcp-teacher-grader-1.2.0.tgz","fileCount":17,"integrity":"sha512-YbAV3C9Ou1dA02TMxsDfu/kLIIleiVIgUN1ajpTxczyBeeDGjojEbPjI7bd+5WKgJ+QzRJw7wNXANHH4/D55fQ==","signatures":[{"sig":"MEQCIAWo+tiQo0OSF0+Ef/2HdRm/V6aLV/trj73KzT2RmkaBAiAhrkzmP5nwWNm9BrVaNZV6PZXn0ow1m+esOfIr7Ti/kQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":115544},"main":"dist/server.js","type":"module","engines":{"npm":">=10.0.0","node":">=20.10.0"},"gitHead":"a2bf3ea6c58935cba0583dbda345aeb96028e24d","scripts":{"build":"tsc && npm run copy-resources","check":"npx tsc --noEmit","clean":"rm -rf feedback_detailed/* || del /q feedback_detailed\\*","grade":"tsx grade_detailed.ts","setup":"node -e \"console.log('Run setup.bat on Windows or setup.sh on Unix systems')\"","start":"tsx src/server.ts","copy-resources":"cp -r rubrics dist/ || xcopy rubrics dist\\rubrics /E /I","prepublishOnly":"npm run build"},"_npmUser":{"name":"arnifa","email":"arnifa+1@gmail.com"},"repository":{"url":"git+https://github.com/arnif/mcp-teacher-grader.git","type":"git"},"_npmVersion":"10.2.3","description":"Intelligent automated grading system for academic assignments using Model Context Protocol","directories":{},"_nodeVersion":"20.10.0","dependencies":{"zod":"^3.25.76","sharp":"^0.34.3","mammoth":"^1.10.0","pdf2pic":"^3.2.0","pdf-parse":"^1.1.1","pdfjs-dist":"^5.4.149","tesseract.js":"^6.0.1","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","typescript":"^5.9.2","@types/node":"^24.3.1","@types/pdf-parse":"^1.1.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-teacher-grader_1.2.0_1757252372169_0.7163832202596974","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@arnifa/mcp-teacher-grader","version":"1.3.0","description":"Intelligent automated grading system for academic assignments using Model Context Protocol","type":"module","main":"dist/server.js","bin":{"mcp-teacher-grader":"bin/cli.js"},"scripts":{"build":"tsc && npm run copy-resources","copy-resources":"cp -r rubrics dist/ || xcopy rubrics dist\\rubrics /E /I","start":"tsx src/server.ts","grade":"tsx grade_detailed.ts","setup":"node -e \"console.log('Run setup.bat on Windows or setup.sh on Unix systems')\"","check":"npx tsc --noEmit","clean":"rm -rf feedback_detailed/* || del /q feedback_detailed\\*","prepublishOnly":"npm run build"},"keywords":["education","grading","automation","mcp","academic","assessment","rubric","feedback","ai-grading","teacher-tools","model-context-protocol"],"author":{"name":"MCP Teacher Grader Team"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/arnif/mcp-teacher-grader.git"},"bugs":{"url":"https://github.com/arnif/mcp-teacher-grader/issues"},"homepage":"https://github.com/arnif/mcp-teacher-grader#readme","engines":{"node":">=20.10.0","npm":">=10.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.17.5","mammoth":"^1.10.0","pdf-parse":"^1.1.1","pdf2pic":"^3.2.0","pdfjs-dist":"^5.4.149","sharp":"^0.34.3","tesseract.js":"^6.0.1","zod":"^3.25.76"},"devDependencies":{"@types/node":"^24.3.1","@types/pdf-parse":"^1.1.5","tsx":"^4.20.5","typescript":"^5.9.2"},"_id":"@arnifa/mcp-teacher-grader@1.3.0","gitHead":"8fffad4b5528c338a940b57daf34bea7cbae8289","_nodeVersion":"20.10.0","_npmVersion":"10.2.3","dist":{"integrity":"sha512-3MYaGsMua8Ngn1oA9Hsviut7jzTQKT1SS6+pYfEoifFPBlHDG8TnN38XVFlMaGCxbrgSOVNm1NhDhlqZXfvQiw==","shasum":"3a2bfcb44fa96d3c1a99193e39e87e9bb6fd2495","tarball":"https://registry.npmjs.org/@arnifa/mcp-teacher-grader/-/mcp-teacher-grader-1.3.0.tgz","fileCount":17,"unpackedSize":112499,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD1cAkT6lxQxGbynR4lOS3ayRovSuDHhx+eG7QUZVc7DwIgcZst0Z3id5UyAfuzEPS52xYW4I/arWmesUVDr/VRxSc="}]},"_npmUser":{"name":"arnifa","email":"arnifa+1@gmail.com"},"directories":{},"maintainers":[{"name":"arnifa","email":"arnifa+1@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-teacher-grader_1.3.0_1757252532424_0.9844014328329047"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-07T12:20:48.180Z","modified":"2025-09-07T13:42:12.814Z","1.0.0":"2025-09-07T12:20:48.596Z","1.0.1":"2025-09-07T12:38:53.201Z","1.1.0":"2025-09-07T13:35:40.149Z","1.2.0":"2025-09-07T13:39:32.377Z","1.3.0":"2025-09-07T13:42:12.614Z"},"bugs":{"url":"https://github.com/arnif/mcp-teacher-grader/issues"},"author":{"name":"MCP Teacher Grader Team"},"license":"MIT","homepage":"https://github.com/arnif/mcp-teacher-grader#readme","keywords":["education","grading","automation","mcp","academic","assessment","rubric","feedback","ai-grading","teacher-tools","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/arnif/mcp-teacher-grader.git"},"description":"Intelligent automated grading system for academic assignments using Model Context Protocol","maintainers":[{"name":"arnifa","email":"arnifa+1@gmail.com"}],"readme":"# 🎓 MCP Teacher Grader\r\n\r\n**Intelligent automated grading system for academic assignments using Model Context Protocol**\r\n\r\n[![npm version](https://badge.fury.io/js/@arnifa%2Fmcp-teacher-grader.svg)](https://www.npmjs.com/package/@arnifa/mcp-teacher-grader)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\r\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.10.0-brightgreen)](https://nodejs.org/)\r\n\r\nTransform your grading workflow with AI-powered analysis that provides detailed, consistent feedback while saving hours of manual review time.\r\n\r\n## ✨ Key Features\r\n\r\n- 🤖 **AI-Powered Analysis**: Advanced text processing with OCR support for scanned documents\r\n- 📋 **Flexible Rubrics**: JSON-based rubric system adaptable to any assignment type  \r\n- 📊 **Comprehensive Analytics**: Class performance insights and individual progress tracking\r\n- 🔍 **Multi-Format Support**: PDF, DOCX, TXT, and Markdown submissions\r\n- 🎯 **Detailed Feedback**: Personalized comments with specific improvement suggestions\r\n- ⚡ **Batch Processing**: Grade entire classes in minutes, not hours\r\n- 🔌 **MCP Integration**: Works seamlessly with Claude Desktop for enhanced AI assistance\r\n\r\n## 🚀 Quick Start\r\n\r\n### Install Globally\r\n```bash\r\nnpm install -g @arnifa/mcp-teacher-grader\r\n```\r\n\r\n### Set Up Your First Project\r\n```bash\r\n# Create and initialize a grading project\r\nmkdir my-assignment-grading && cd my-assignment-grading\r\nmcp-teacher-grader init\r\n```\r\n\r\n### Start Grading\r\n```bash\r\n# Place student submissions in submissions/ folder\r\n# Customize your rubric in rubrics/\r\nmcp-teacher-grader grade\r\n```\r\n\r\nThat's it! The system will process all submissions and generate detailed feedback.\r\n\r\n## 📖 Documentation\r\n\r\n- **[Installation Guide](INSTALL.md)** - Detailed setup instructions\r\n- **[Contributing Guidelines](CONTRIBUTING.md)** - How to contribute to the project\r\n- **[Example Rubrics](rubrics/)** - Templates for different assignment types\r\n\r\n## 🎯 Perfect For\r\n\r\n- **Computer Science Courses**: Code analysis, algorithm explanations, software design\r\n- **Writing Assignments**: Essays, reports, research papers\r\n- **STEM Subjects**: Problem-solving steps, mathematical proofs, lab reports\r\n- **Any Subject**: Customizable rubrics adapt to your specific needs\r\n\r\n## 🔧 Advanced Usage\r\n\r\n### Claude Desktop Integration\r\n```bash\r\n# Install and configure for use with Claude Desktop\r\nmcp-teacher-grader server\r\n```\r\n\r\nAdd to your Claude Desktop config:\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"teacher-grader\": {\r\n      \"command\": \"mcp-teacher-grader\",\r\n      \"args\": [\"server\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Custom Rubrics\r\nCreate specialized rubrics for different assignment types:\r\n```json\r\n{\r\n  \"name\": \"Essay Grading Rubric\",\r\n  \"totalPoints\": 100,\r\n  \"questions\": [\r\n    {\r\n      \"id\": \"thesis\",\r\n      \"description\": \"Thesis Statement Quality\",\r\n      \"points\": 25,\r\n      \"criteria\": [\"Clear position\", \"Arguable claim\", \"Proper placement\"]\r\n    }\r\n  ]\r\n}\r\n```\r\n\r\n## 📊 Sample Output\r\n\r\nThe system generates:\r\n- **Individual feedback files** with detailed analysis\r\n- **Class performance summary** with grade distribution\r\n- **Question-by-question insights** identifying common issues\r\n- **Improvement recommendations** for both students and instruction\r\n\r\n## 🤝 Contributing\r\n\r\nWe welcome contributions! This project is designed to help educators worldwide. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\r\n\r\n## 📄 License\r\n\r\nMIT License - see [LICENSE](LICENSE) for details.\r\n\r\n## 🔗 Links\r\n\r\n- **npm Package**: [@arnifa/mcp-teacher-grader](https://www.npmjs.com/package/@arnifa/mcp-teacher-grader)\r\n- **GitHub Repository**: [arnif/mcp-teacher-grader](https://github.com/arnif/mcp-teacher-grader)\r\n- **Bug Reports**: [GitHub Issues](https://github.com/arnif/mcp-teacher-grader/issues)\r\n\r\n---\r\n\r\n**Transform your grading process today. Install with `npm install -g @arnifa/mcp-teacher-grader` and start saving time while improving feedback quality!** 🎓\r\n","readmeFilename":"README.md"}