````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)