EduChain MCP Server - 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

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

⚠️ 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

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

🖥️ 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.