MCP-Educhain-Server

Thanusri-2-3/MCP-Educhain-Server

3.2

If you are the rightful owner of MCP-Educhain-Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The EduChain MCP Server Assignment is a project designed to set up an MCP server using the EduChain library, integrating it with Claude Desktop to provide educational content generation tools.

Tools

  1. MCQ Generator Tool

    Generates multiple choice questions based on a given topic.

  2. Flashcard Generator

    Creates flashcards with question-answer pairs for quick learning.

EduChain MCP Server Assignment 🚀

This project is built as part of the BuildFastWithAI assignment. It sets up an MCP server using the EduChain library, integrates it with Claude Desktop, and exposes educational content generation tools such as:

  • ✅ Multiple Choice Questions (MCQ) Generator
  • ✅ Lesson Plan Generator
  • ⭐ Bonus: Flashcard Generator

📁 Folder Structure

mcp-educhain-assignment/
├── server.py                      # Flask-based MCP server
├── educhain_tools.py             # Tools for MCQs and lesson plans
├── claude_desktop_config.json    # Claude Desktop config file
├── Sample_Responses.txt          # Sample prompt-response logs
├── requirements.txt              # Project dependencies
└── README.md                     # Project documentation (this file)

🧠 Tools and Resources Exposed to Claude

1. MCQ Generator Tool

  • Endpoint: /tool/generate_mcqs
  • Method: POST
  • Input: 
    {
  "topic": "Python loops",
  "num_questions": 5
}
  • Output: JSON with list of questions and options

2. Lesson Plan Resource

  • Endpoint: /resource/lesson_plan
  • Method: POST
  • Input: 
    {
  "subject": "Algebra"
}
  • Output: Structured lesson plan content

3. Bonus: Flashcard Generator

  • Endpoint: /tool/generate_flashcards
  • Method: POST
  • Input: 
    {
  "topic": "Photosynthesis"
}
  • Output: Flashcards with question-answer pairs

🧪 Sample Prompts (for Claude Desktop)

You can try these in Claude after proper config:

Use MCQ Generator with topic: Python loops and num_questions: 5  
Use Lesson Plan Generator with subject: Algebra  
Use Flashcard Generator with topic: Photosynthesis

🔌 How to Run the Server

1. Clone the repo and create a virtual environment

git clone https://github.com/<your-username>/mcp-educhain-assignment.git
cd mcp-educhain-assignment
python -m venv venv
venv\Scripts\activate  # On Windows

2. Install dependencies

pip install -r requirements.txt

3. Run the server

python server.py

The server will start at:

http://127.0.0.1:9000/

🧩 Claude Desktop Setup

  1. Ensure the claude_desktop_config.json file is placed inside:

    C:\Users\<your-username>\.claude\claude_desktop_config.json

  2. Open Claude Desktop → Edit Config → Confirm tools are listed.

  3. Type supported prompts like:

    • Generate 5 MCQs on Python loops
    • Provide a lesson plan on Algebra
    • Create flashcards on Photosynthesis

📦 Deliverables Summary

  • MCP server with 2 core tools
  • Claude Desktop configuration
  • Sample responses in Sample_Responses.txt
  • Bonus tool: Flashcard generator
  • Well-documented code and README

🧾 Credits

  • EduChain Library by Satvik
  • Claude Desktop and MCP SDK from Anthropic
  • Assisted with OpenAI GPT-4o for debugging and documentation