MohammedRayan11/educhain-mcp-server

🧠 EduChain MCP Server

This project is a Modular Command Platform (MCP) server built using Python that integrates EduChain tools such as MCQ generation and lesson planning. It is designed to interface with AI platforms like Claude Desktop to provide intelligent educational resources dynamically.

🚀 Features

• ✅ Python-based MCP Server
• 🛠️ Two tools integrated:
  • Generate MCQs – Produces multiple-choice questions for a given topic
  • Generate Lesson Plan – Generates structured lesson plans for any subject
• 🤝 Works with Claude Desktop via JSON configuration
• 🧩 Easily extendable (supports additional tools like flashcards)

🗂️ Project Structure

📦 educhain-mcp-server/ ├── main.py # Runs the MCP server and registers tools ├── educhain.py # Contains MCQGenerator and LessonPlanGenerator classes ├── requirements.txt # Required Python packages ├── claude_desktop_config.json # Optional: Claude integration config ├── Sample_Responses.txt # Test queries and outputs ├── README.md # Project documentation ├── .gitignore # Git exclusions

yaml Copy code

💻 Setup Instructions

1️⃣ Clone the Repository

git clone https://github.com/MohammedRayan11/educhain-mcp-server.git
cd educhain-mcp-server
2️⃣ Create and Activate a Virtual Environment
bash
Copy code
python -m venv .venv
.venv\Scripts\activate  # On Windows
3️⃣ Install Dependencies
bash
Copy code
pip install -r requirements.txt
⚠️ If mcp_sdk isn't available on PyPI, use this instead:

bash
Copy code
pip install -e .
▶️ Running the Server
bash
Copy code
python main.py
You should see:

less
Copy code
[MCPServer] Running EduChainMCP: MCP Server using EduChain tools.
[Tool] generate_mcqs - Generate MCQs for a given topic.
[Tool] generate_lesson_plan - Generate a lesson plan for a given subject.
🧪 Testing with Claude Desktop
Install Claude Desktop from Anthropic.

Update your claude_desktop_config.json to point to your local MCP server.

Run main.py and open Claude Desktop.

Try prompts like:

nginx
Copy code
Generate 5 multiple-choice questions on Python loops.
Provide a lesson plan for teaching algebra.
Claude will fetch results from the MCP server and display them.