Name: EduChain MCP Server
Author: AyaanShaheer

# 🚀 EduChain MCP Server The **EduChain MCP Server** integrates the [EduChain](https://github.com/satvik314/educhain) library with the [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol/python-sdk) to build a local educational content server for **Claude Desktop**. It runs via `stdio` and leverages **Grok's free-tier** (xAI) to generate: - ✅ Multiple-choice questions - 📚 Lesson plans - 💡 Flashcards Currently focused on **Python programming** and **Algebra**, this server provides AI-powered tools tailored to real-world educational scenarios. --- ## ⚙️ Setup Instructions (Windows + VS Code) 1. **Clone the Repository** ```bash git clone https://github.com/AyaanShaheer/EduChain-MCP-Server cd educhain-mcp-server

Create and Activate Virtual Environment
python -m venv venv .\venv\Scripts\activate
Install Dependencies
pip install mcp httpx educhain
Run the MCP Server
python mcp_educhain_server.py

🖥️ Claude Desktop Configuration

Edit the config file:

📍 C:\Users\Ayaan\AppData\Roaming\Claude\claude_desktop_config.json

{ "mcpServers": { "EduChainServer": { "command": "C:\\Users\\Ayaan\\Desktop\\educhain-mcp-server\\venv\\Scripts\\python.exe", "args": ["C:\\Users\\Ayaan\\Desktop\\educhain-mcp-server\\mcp_educhain_server.py"], "env": { "PYTHONPATH": "C:\\Users\\Ayaan\\Desktop\\educhain-mcp-server" } } } }

🔁 Replace <YourUsername> with your actual Windows username.

✨ Features

🧠 Multiple-Choice Questions Generate quizzes with options, answers, and explanations.
🧑‍🏫 Lesson Plans Create structured teaching plans (e.g., Algebra).
🃏 Flashcards Outputs HTML-based flashcards manually (due to API limitations).

📌 Usage Examples

Start the server
Open Claude Desktop
Try commands like:

"Generate 5 multiple-choice questions on Python loops." "Provide a lesson plan for teaching algebra." "Generate 5 flashcards on Python Programming Basics."

📂 Responses are saved in: Sample_Responses.txt