EduChain

EduChain MCP Server integrates EduChain's educational content generation capabilities with MCP-compatible clients, enabling you to generate MCQs, lesson plans, and flashcards through Claude Desktop or other MCP tools. This server emphasizes type safety, robust error handling, and thorough input validation to support reliable educational tooling.

How to use

You connect an MCP client to the EduChain MCP Server to access three educational tools. From your MCP client, you can request MCQs for a topic, generate a complete lesson plan, or create a set of study flashcards. Each tool is designed to be easy to use with clear input parameters and reliable output.

How to install

# Prerequisites
# - Python 3.10 or higher
# - OpenAI API key for EduChain features
# - MCP-compatible client (e.g., Claude Desktop)

# Step 1: Clone the project
git clone https://github.com/yourusername/educhain-mcp.git
cd educhain-mcp

# Step 2: Install dependencies
pip install -e .

# Alternative manual install (if needed)
pip install educhain>=0.3.10 httpx>=0.28.1 "mcp[cli]>=1.10.1" python-dotenv

# Step 3: Set up environment variable (example)
# Create a .env file at the project root with your OpenAI key
OPENAI_API_KEY=your_openai_api_key_here

# Step 4: Run the MCP server
python mcp_server.py

Configuration and runtime details

The server is designed to run as a local MCP service and integrate with Claude Desktop via the standard stdio transport. You configure the MCP client to connect to the local server. The following configuration enables Claude Desktop to launch the server as a local process.

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

Claude Desktop configuration

Add a new MCP server entry in Claude Desktop to enable seamless interaction with EduChain tools. Use the local stdio transport so Claude Desktop can start the server and communicate with it.

MCP Inspector

For debugging and development, you can inspect MCP activity using the Inspector tool. This helps verify inputs, outputs, and protocol traffic during tool usage.

Logging and error handling

The server logs all major events at INFO, WARNING, and ERROR levels. You will see startup messages, tool execution results, and any errors with detailed context to facilitate debugging.

Environment and security notes

Environment variables are supported for configuring the server, including your OpenAI API key. Protect sensitive values and avoid committing them to public repositories.

Notes on performance and reliability

Inputs are thoroughly validated to prevent invalid requests from propagating. The server aims for graceful degradation, returning structured error responses when something goes wrong, while keeping as much functionality available as possible.

Available tools

generate_mcqs

Generate multiple-choice questions for a given topic with a specified quantity.

lesson_plan

Create a comprehensive, structured lesson plan including objectives, activities, and assessments.

generate_flashcards

Produce educational flashcards suitable for spaced repetition learning with optional difficulty levels.