EduChain

Exposes educational AI tools (MCQ generation, lesson planning, flashcards) via MCP using a local Python server and Ollama

python

0

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "skmalik768-content-generator-using-educhain-lib": {
      "command": "python",
      "args": [
        "mcp_server.py"
      ],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

You run an EduChain MCP Server locally to access educational AI tools—MCQ generation, lesson planning, and flashcard creation—through the Model Context Protocol (MCP). This setup connects a local Python MCP server with Ollama’s LLM and Claude for Desktop, enabling seamless tool invocation from your MCP client.

How to use

You interact with the EduChain MCP Server from an MCP client. Start the local server, then issue requests from your client to request MCQs for a topic, generate a structured lesson plan, or build flashcards. You can combine prompts to build coherent learning plans or create study aids for any subject. When you start the server, it exposes the available tools so your client can call them by name and receive structured responses.

How to install

Prerequisites you need on your machine before starting: a recent Python 3.10+ installation, Ollama (with a local LLM such as Gemma or Mistral), and Claude for Desktop. You will also install a couple of Python dependencies to enable the MCP workflow.

Step-by-step commands to set up and run the server locally:

Additional sections

Configuration and startup details are shown below. You will configure a Claude desktop MCP entry to launch the local Python server, then run the server and verify it responds to tool requests.

{
  "mcpServers": {
    "educhain-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

Troubleshooting and notes

If you encounter issues, ensure you are using absolute paths for any working directory references and that PYTHONIOENCODING is set to UTF-8. Print debug logs to stderr to capture any startup errors, and check Claude logs via the logs folder to diagnose configuration problems.

Available tools

generate_mcqs

Generates MCQs for a given topic to help assess understanding and prepare practice questions.

generate_lesson_plan

Creates structured lesson plans outlining goals, activities, and assessment points for topics.

generate_flashcards

Builds flashcards from topics to support quick-recall study sessions.