EduChain MCP Integration Server

# EduChain MCP Integration Server This project implements an **MCP-compatible Flask server** that integrates with the [`educhain`](https://github.com/satvik314/educhain) Python library to dynamically generate educational content for Claude Desktop. It provides three core educational tools: - 🧠 Multiple-Choice Questions (MCQs) - 📘 Lesson Plans - 🃏 Flashcards (Bonus) --- ## 🚀 Features - 📡 Exposes REST API endpoints for Claude Desktop integration - 🔐 Uses `.env` file to securely manage OpenAI API keys - 📦 Lightweight and easy to deploy - 🧪 Includes sample responses and test script --- ## 🛠️ Technologies Used - Python 3.10+ - Flask - EduChain (via `educhain` package) - dotenv (`python-dotenv` for secure API handling) - Claude Desktop MCP Protocol (local JSON config) --- ## 📦 Setup Instructions ### 1. Clone the Repository ```bash git clone https://github.com/abanindra3/educhain-mcp.git cd educhain-mcp 2. Create and Activate Virtual Environment (Recommended) python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate 3. Install Dependencies pip install -r requirements.txt pip install flask python-dotenv 4. Create .env File Create a .env file in the root directory and add your OpenAI API key: OPENAI_API_KEY=your_openai_key_here 5. Run the Server python mcp_server.py Server will run at: 📍 http://localhost:5000 6. Test the Endpoints You can run: python test_server.py Or test manually using Postman/Hoppscotch with these POST endpoints: Endpoint Purpose Sample Payload /generate_mcqs Generate MCQs { "topic": "Python loops", "count": 5 } /generate_lesson_plan Create a lesson plan { "subject": "Algebra" } /generate_flashcards Generate flashcards (bonus) { "topic": "OOP in Java", "count": 6 }