Homework Grading MCP

# 📋 更新日志 ## v2.0.2 (2025-12-04) ### 🔧 修复 - **错误处理优化** - 改进了API密钥缺失时的错误处理机制 - **启动流程优化** - 服务器现在可以在没有API密钥的情况下启动 - **连接稳定性** - 修复了MCP客户端连接问题 ## v2.0.1 (2025-12-04) ### 🔧 修复 - **可执行文件配置** - 添加缺失的bin字段，修复npx运行错误 - **包结构优化** - 确保正确发布可执行文件 ## v2.0.0 (2025-12-04) ### 🎉 重大版本发布 - **全新架构** - 基于MCP协议的完整重构 - **功能完善** - 包含所有核心作业批改功能 - **生产就绪** - 可直接用于生产环境 ### ✨ 核心功能 - **智能批改** - 基于Qwen3-VL多模态模型的作业批改 - **批量处理** - 支持同时批改多份作业 - **多科支持** - 支持数学、语文、英语等多个学科 - **详细反馈** - 提供逐题解析和总体评价 - **MCP兼容** - 完整支持Model Context Protocol ## v1.0.1 (2025-12-04) ### 🔧 修复 - **Windows兼容性** - 修复了npm脚本在Windows系统下的清理命令 - **包发布优化** - 改进了包发布流程和错误处理 ## v1.0.0 (2025-01-01) ### 🎉 初始版本发布 #### ✨ 新增功能 - 📝 **单份作业批改** - 支持上传单张作业图片进行智能批改 - 📚 **批量作业批改** - 支持同时批改多份学生作业 - 🎯 **多种题型支持** - 支持选择题、填空题、计算题、作文题 - 📊 **详细批改结果** - 提供逐题评分、解析说明和总体反馈 - 🎨 **多科目支持** - 支持数学、语文、英语、物理、化学、地理、历史、生物等科目 - 🔍 **图片格式验证** - 自动验证和压缩上传的作业图片 - 📝 **结构化输出** - 按照标准JSON格式返回批改结果 - 🚀 **MCP协议支持** - 完整兼容Model Context Protocol规范 #### 🔧 技术特性 - **TypeScript开发** - 完整的类型定义和类型安全 - **模块化架构** - 清晰的服务分层和工具分离 - **错误处理** - 完善的异常捕获和错误提示 - **日志系统** - 分级别的日志记录功能 - **环境配置** - 灵活的环境变量管理 - **图片处理** - Base64图片验证和压缩功能 #### 📋 支持的工具 - `grade_homework` - 智能批改单份作业 - `batch_grade_homework` - 批量批改多份作业 #### 🎯 评分标准 - **A级 (90-100%)** - 优秀表现 - **B级 (80-89%)** - 良好表现 - **C级 (70-79%)** - 中等表现 - **D级 (60-69%)** - 及格表现 - **F级 (<60%)** - 需要改进 #### 🔌 集成支持 - **VS Code + Cline** - 完整配置示例 - **Claude Desktop** - 详细配置说明 - **其他MCP客户端** - 标准MCP协议兼容 --- ## 🚀 后续计划 ### v1.1.0 (计划中) - 🎯 **自定义评分标准** - 支持用户自定义评分规则 - 📈 **统计分析** - 提供作业批改数据统计 - 🔄 **历史记录** - 支持查看历史批改记录 - 🎨 **结果导出** - 支持导出批改结果为多种格式 ### v1.2.0 (计划中) - 🤖 **模型优化** - 集成更多AI模型选择 - 📝 **手写识别增强** - 提升手写文字识别准确率 - 🔍 **错题分析** - 提供详细的错题分析报告 - 📱 **移动端支持** - 优化移动端使用体验 --- ## 📞 反馈与支持 如有问题或建议，请通过以下方式联系： - 📧 邮箱: pickstar-2002@example.com - 🐛 GitHub Issues: [提交Issue](https://github.com/pickstar-2002/homework-grading-mcp/issues) **⭐ 如果这个项目对你有帮助，请给个 Star！**