AI导哈

教育内容生成服务器

EduChain MCP Server是一个基于EduChain库的教育内容生成服务器，支持生成多项选择题、教案和闪卡，兼容Claude Desktop。

  • by Premvkmishra
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 premvkmishra/mcp_server

使用说明

EduChain MCP服务器

概述

该项目使用EduChain库实现了用于教育内容生成的MCP服务器。它公开了生成MCQ、课程计划和抽认卡的工具，并与Claude Desktop兼容。

特性

  • 生成多项选择题（MCQ）
  • 创建结构化的课程计划
  • 生成抽认卡（奖励工具）
  • 完全符合MCP协议
  • 异步、稳健的错误处理和日志记录

项目结构

educhain-mcp-server/
├── src/
│   ├── __init__.py
│   ├── mcp_server.py
│   ├── educhain_wrapper.py
│   ├── educhain_mock.py
│   └── utils.py
├── config/
│   └── config.json
├── tests/
│   ├── test_server.py
│   └── sample_responses.txt
├── requirements.txt
├── README.md
├── run_server.py
└── Sample_Responses.txt

安装说明

  1. 克隆存储库。
  2. 安装依赖项：
    pip install -r requirements.txt
  3. （可选）设置OpenAI API密钥（如果您有）。
  4. 运行服务器：
    python run_server.py
  5. （可选）直接测试：
    python test_direct.py

使用示例

看 Sample_Responses.txt 例如命令和输出。

样本输出

下面是一个运行直接测试脚本的示例：

$ python test_direct.py
--- Testing generate_mcqs ---
MCQs: [{'question': 'Sample question about Python loops (medium)', 'options': ['A', 'B', 'C', 'D'], 'correct_answer': 'A', 'explanation': 'Sample explanation.'}, ...]
--- Testing create_lesson_plan ---
Lesson Plan: {'objectives': ['Learn algebra'], 'activities': ['Lecture', 'Practice'], 'assessment': 'Quiz'}

--- Testing generate_flashcards ---
Flashcards: [{'front': 'Front 1 about basic mathematics', 'back': 'Back 1'}, ...]

关于EduChain集成的说明

由于缺乏OpenAI API访问，本项目使用EduChain API的模拟实现进行演示和测试。集成和工具结构与真正的EduChain API完全兼容。

引用

  • EduChain库：https://github.com/satvik314/educhain
  • MCP协议：https://github.com/anthropics/anthropic-mcp

（可选）视频演练

[链接到视频演练（如果您制作了视频演练）]

测试

  • 看 tests/test_server.py 用于自动化测试。
  • 看 tests/sample_responses.txt 用于示例命令和响应。

错误处理

  • 所有工具都会验证参数并返回用户友好的错误消息。
  • 记录并报告网络/API故障。

故障排除

  • 确保安装了所有依赖项。
  • 检查日志以了解错误详细信息（使用 --debug 用于详细输出）。
  • 如果EduChain API不可用，工具将返回一条明确的错误消息。

许可证

麻省理工学院

相关 MCP