AyaanShaheer/EduChain-MCP-Server

# 🚀 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

   python -m venv venv
   .\venv\Scripts\activate
   

3. Install Dependencies

   pip install mcp httpx educhain
   

4. 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

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
• ⚙️ MCP SDK: https://github.com/modelcontextprotocol/python-sdk