MCP 服务器

EduChain MCP Server

Integrates the EduChain library to generate educational content including multiple-choice questions, lesson plans, and flashcards for subjects like Python programming and Algebra using Grok's free-tier LLM.

README

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