🧠 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