# 🧠 EduChain MCP Server (Claude + Ollama)
This project exposes **educational AI tools** like multiple choice question (MCQ) generation, lesson planning, and flashcard creation via the **Model Context Protocol (MCP)**.
It connects:
- ✅ Local **Python MCP server**
- ✅ Local **Ollama LLM (e.g., Gemma)**
- ✅ **Claude for Desktop** using `claude_desktop_config.json`
---
## 🚀 Features
| Tool Name | Description |
|------------------------|-------------|
| `generate_mcqs` | Generates MCQs for a given topic |
| `generate_lesson_plan` | Creates structured lesson plans |
| `generate_flashcards` | Builds flashcards from topics |
Powered by [`Educhain`](https://github.com/ritobanrc/educhain) and a local LLM from Ollama.
---
## 📁 Project Structure
mcp-educhain-server/
├── mcp_server.py # Main MCP server
├── educhain_content.py # AI tool logic using Educhain + Ollama
├── claude_desktop_config.json # Claude config (external)
├── README.md
yaml
Copy
Edit
---
## ⚙️ Requirements
- Python 3.10+
- [Ollama](https://ollama.com/) (e.g., `gemma`, `mistral`)
- Claude for Desktop
- Dependencies:
```bash
pip install educhain langchain_ollama
🔌 Claude Config (claude_desktop_config.json)
Located at:
bash
Copy
Edit
%APPDATA%\Claude\claude_desktop_config.json
Use this format:
json
Copy
Edit
{
"mcpServers": {
"educhain-server": {
"command": "C:\\Users\\YourUsername\\AppData\\Local\\Programs\\Python\\Python310\\python.exe",
"args": ["mcp_server.py"],
"workingDirectory": "C:\\Users\\YourUsername\\Desktop\\mcp-educhain-server",
"env": {
"PYTHONIOENCODING": "utf-8"
}
}
}
}
🧪 Test Your Server
In terminal:
bash
Copy
Edit
cd mcp-educhain-server
python mcp_server.py
Check with:
bash
Copy
Edit
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | python mcp_server.py
🧠 Example Prompts in Claude
"Generate 5 MCQs on Photosynthesis"
"Create a lesson plan for Algebra"
"Make flashcards for World War 2"
🐛 Troubleshooting
✅ Use absolute paths in the config
✅ Add PYTHONIOENCODING=utf-8
✅ Print debug logs to stderr
Check Claude logs via “Open Logs Folder”
📜 License
MIT License
✨ Credits
Educhain
Ollama
Claude Desktop
