EduChain Server

This project is an AI-powered MCP (Model Context Protocol) server built using the EduChain library. It integrates with Claude Desktop and provides tools to generate educational content such as:

• ✅ Multiple Choice Questions (MCQs)
• ✅ Lesson Plans
• ✅ Flashcards

---

⚙️ Features

Tool	Description
generate_mcqs	Generates multiple-choice questions based on a topic
generate_lesson_plan	Creates a structured lesson plan
generate_flashcards	Creates Q&A flashcards for study

---

🚀 Setup Instructions

These steps will guide you through installing everything and running the server with Claude Desktop.

---

🧰 Step 1: Install uv (if not already)

curl -LsSf https://astral.sh/uv/install.sh | sh

---

🐍 Step 2: Create and activate a virtual environment

uv venv
source .venv/bin/activate

---

📦 Step 3: Install EduChain (from local GitHub repo)

uv pip install -e /absolute/path/to/educhain-main

If you haven’t already, first clone the EduChain GitHub repository: then follow step 3

Example:

uv pip install -e /Users/kunal/Desktop/github/educhain-main

---

📦 Step 4: Install MCP + httpx

uv add "mcp[cli]" httpx

---

🧠 Step 5: Add Your API Key in server.py

In server.py, replace this line with your actual key:

os.environ["OPENAI_API_KEY"] = "sk-..."  # ← Your OpenAI API key here

⚠️ This is not recommended for production but acceptable for testing/submission.

---

▶️ Running the Server

Make sure you're in the project folder and the virtual environment is activated.

Then run:

uv run server.py

If successful, you'll see:

✅ EduChain MCP FastMCP server is starting...

---

💻 Claude Desktop Configuration

Update your claude_desktop_config.json like this:

{
  "mcpServers": {
    "educhain": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/eduMcp",
        "run",
        "server.py"
      ]
    }
  }
}

Restart Claude Desktop to reload the config.

---

💬 Example Prompts in Claude

Use the `generate_mcqs` tool to create 3 questions on "Photosynthesis".

Use the `generate_lesson_plan` tool for "Newton's Laws of Motion".

Use the `generate_flashcards` tool to make flashcards on "The Solar System".

Made using EduChain + Claude.