nisthajain12/educhain-mcp-server

EduChain MCP Server + Claude Desktop UI

This project integrates the EduChain content generation library with a custom MCP-compliant Flask server, along with a desktop UI (Claude Desktop Simulator) built using Tkinter.

It allows users to generate educational content such as:

• 📘 Multiple-choice questions (MCQs)
• 📋 Lesson plans
• 📄 Summaries
• 🃏 Flashcards
• 📎 Simulated PDFs
• 📺 Quizzes from YouTube videos

🧱 Folder Structure

educhain_mcp_server/
├── mcp_server.py         # Main Flask server exposing EduChain tools via API
├── claude_desktop.py     # Tkinter GUI that simulates Claude Desktop
├── api_server.py         # Alternate server interface (optional)
├── main.py               # Entry point for testing/debugging
├── tools/                # Integrated EduChain tools (MCQ, summary, flashcards, etc.)
│   ├── mcq_generator.py
│   ├── flashcard_generator.py
│   ├── pdf_generator.py
│   ├── summary_tool.py
│   ├── lesson_plan_generator.py
│   ├── youtube_quiz_generator.py
│   ├── summarizer.py
├── utils/
│   └── helpers.py        # Utility for saving tool outputs
├── outputs/              # Auto-generated `.txt` content
├── requirements.txt      # Required Python packages
└── README.md             # Project documentation

🚀 Features

🚀 Setup Instructions

1. Clone the Repository bash Copy Edit git clone https://github.com/nisthajain12/educhain-mcp-server.git cd educhain-mcp-server

2. Create a Virtual Environment On Windows: bash Copy Edit python -m venv venv venv\Scripts\activate On macOS/Linux: bash Copy Edit python3 -m venv venv source venv/bin/activate

3. Install Dependencies bash Copy Edit pip install -r requirements.txt ✅ Make sure educhain is installed via PyPI or from source.

4. Run the MCP Server bash Copy Edit python mcp_server.py The server will start on http://127.0.0.1:5000

5. Simulate Claude Desktop UI (Optional) bash Copy Edit python claude_desktop_sim.py Use this to test the MCP tools via a desktop-like interface.

💡 Notes

If you're running in offline mode or without OpenAI API access, dummy responses are returned for each tool.

Proper error handling is built-in for unsupported or failed requests.

✨ Example Commands

From Claude Desktop (GUI), you can:

Enter a topic like Photosynthesis and press "Generate MCQs"

View structured output and saved result in /outputs/

📬 Contact

For questions or collaboration, feel free to reach out: 📧

🏷️ Badges

📂 Output Samples

All generated content is saved to the outputs/ directory in .txt format.

Each tool (e.g., MCQ Generator, Lesson Planner) automatically saves responses via the helpers.py utility.

📸 Screenshot of Output (Claude Desktop)

👥 Contributors

Feel free to reach out for collaboration or questions!

📚 Citation

This project makes use of the following external tools and references:

• EduChain
  AI-based educational content generation engine.
  🔗 GitHub Repository
  📦 PyPI Package
  📖 Official documentation and usage examples provided by the EduChain team.

• Claude Desktop MCP Reference
  MCP (Multi-Modal Control Protocol) UI simulation is inspired by Claude-style desktop interactions.
  This implementation uses a local Tkinter GUI to simulate Claude-like functionality.

If you're using this project in your own research or application, you may cite it as:

@misc{nisthajain2025educhainmcp,
  author       = {Nistha Jain},
  title        = {EduChain MCP Server: AI-powered educational content interface},
  year         = {2025},
  howpublished = {\url{https://github.com/nisthajain12/educhain-mcp-server}},
  note         = {Combines EduChain with a local MCP-compliant server and Claude-style desktop UI.}
}

⚖️ License

This project is licensed under the MIT License.

MIT License

Copyright (c) 2025 Nistha Jain

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the “Software”), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

(Full license text at https://opensource.org/licenses/MIT)

⭐️ Show Your Support If you found this useful, give it a ⭐️ on GitHub!