````markdown
# 🚀 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
````
2. **Create and Activate Virtual Environment**
```bash
python -m venv venv
.\venv\Scripts\activate
```
3. **Install Dependencies**
```bash
pip install mcp httpx educhain
```
4. **Run the MCP Server**
```bash
python mcp_educhain_server.py
```
---
## 🖥️ Claude Desktop Configuration
Edit the config file:
📍 `C:\Users\Ayaan\AppData\Roaming\Claude\claude_desktop_config.json`
```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
1. Start the server
2. Open Claude Desktop
3. 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`
---
## ⚠️ Known Limitations
* Flashcard support via `educhain` is experimental.
Use the manually generated HTML version in `Sample_Responses.txt`.
---
## 📅 Project Status
* 🗓️ Last updated: **July 3, 2025**
* ✅ Verified on **Windows + VS Code + Claude Desktop**
* 🧪 Tested using **Grok's free-tier LLM**
---
## 📚 Citations
* 🧩 EduChain: [https://github.com/satvik314/educhain](https://github.com/satvik314/educhain)
* ⚙️ MCP SDK: [https://github.com/modelcontextprotocol/python-sdk](https://github.com/modelcontextprotocol/python-sdk)
