Generates educational content like MCQs, lesson plans, and flashcards
🧠 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` 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 (e.g.,
gemma,mistral) - Claude for Desktop
- Dependencies:
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
Tools (3)
generate_mcqsGenerates MCQs for a given topicgenerate_lesson_planCreates structured lesson plansgenerate_flashcardsBuilds flashcards from topicsEnvironment Variables
PYTHONIOENCODINGrequiredSet to utf-8 to ensure proper character encodingConfiguration
{
"mcpServers": {
"educhain-server": {
"command": "python",
"args": ["mcp_server.py"],
"workingDirectory": "/path/to/mcp-educhain-server",
"env": {
"PYTHONIOENCODING": "utf-8"
}
}
}
}