EduChainMCP

๐Ÿ“š Educhain MCP Integration with Claude (via MCP Protocol)

This repository provides an integration of the Educhain Python library with the Claude AI platform using the Model Context Protocol (MCP). It allows you to use Claude or Claude Studio to generate:

  • โœ๏ธ Multiple-choice questions (MCQs)
  • ๐Ÿง  Structured lesson plans

Powered by Gemini 1.5 Flash (via Langchain) and a custom LLM configuration using Educhain's educational toolkit.


๐Ÿš€ Features

  • โœ… Claude-native MCP integration
  • โœ… Uses OpenAI-compatible Claude Inspector & Claude Desktop apps
  • โœ… Tool registration with Educhainโ€™s QnA and LessonPlan engines
  • โœ… Gemini 1.5 Flash as the backend LLM
  • โœ… Easily extensible for more tools

๐Ÿงฑ Requirements

  • Python 3.10 or later
  • A Claude-compatible MCP runtime (uv)
  • A valid Gemini API Key from Google
  • Educhain PyPI package installed
  • Claude Desktop and MCP Inspector installed

๐Ÿ› ๏ธ Setup Instructions

.### 1. Create and activate a virtual environment

python -m venv venv source venv/bin/activate # For Linux/macOS venv\Scripts\activate # For Windows pip install educhain

2.. Add your Gemini API key in .env

GOOGLE_API_KEY=your_actual_gemini_api_key

3. Set up and test EduChain with Gemini

4. Install MCP

pip install mcp[cli]

5. Write the mcp tools using educhain in main.py

tool1 : generate question and answer tool2 : generate lesson plan

6.Run and test in MCP inspector

uv run mcp dev main.py
image

image

then add tool to claude desktop using command :

uv run mcp install main.py image

On claude Desktop :

image Then restart claude and we can use our tools easily . image image

testing on claude desktop

image image