Which integrations are available for this server?

Uses local Ollama LLMs to generate educational content, including multiple choice questions (MCQs), structured lesson plans, and flashcards.

How do I use EduChain MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@EduChain MCP Server generate 5 MCQs on photosynthesis for a high school biology class" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

🧠 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