JEEVAKARTHIKEYAN1/MCP_Server_Educhain

EduChain MCP Server Integration

📚 Project Overview

This project demonstrates how to integrate the educhain library into an MCP (Modular Command Protocol) server to generate educational content dynamically. The MCP server is configured to expose tools and resources to external clients like Claude Desktop.

🛠️ Features

• ✅ Generate multiple-choice questions (MCQs) using the EduChain engine
• ✅ Generate a lesson plan for any given educational topic
• ✅ MCP-compliant server integration using the mcp SDK
• ✅ Compatible with Claude Desktop (via claude_desktop_config.json)
• ✅ Responses formatted as JSON for easy consumption

🎥 Demo Video

The demo video showing the MCP server in action is included in the repository:

Download Demo Video

🗂️ Project Structure

mcp-server-demo/
│
├── .env # Environment variables (optional)
├── .gitignore # Git ignore rules
├── .python-version # Python version for pyenv (if used)
├── claude_desktop_config.json # Configuration file for Claude Desktop
├── educhain_engine.py # Custom EduChain wrapper functions
├── main.py # (Optional) Entry script
├── server.py # MCP server implementation
├── requirements.txt # Python dependencies
├── pyproject.toml # MCP project metadata
├── uv.lock # Dependency lockfile (uv)
└── README.md # This documentation

⚙️ Setup and Installation

Clone the Repository:

git clone [your-github-repository-url]
cd MCP_Server_Educhain

Install uv:

# On most systems:
pip install uv

Install Dependencies:

uv add -r requirements.txt

Set Up API Key:

1. Create a .env file in the root directory
2. Add your Google API key:

GOOGLE_API_KEY="your-api-key-goes-here"

▶️ How to Run

Start the MCP server from your terminal:

uv run mcp install server.py

The server will expose tools for generating MCQs, lesson plans, and flashcards via MCP.

📚 Resources

• Educhain Library
• MCP Documentation
• Claude Desktop Download