EduChain MCP Server

How to use

You run the EduChain MCP Server locally and connect it to an MCP client such as Claude Desktop. Start the server, then configure Claude Desktop to load the EduChain MCP Server as an MCP endpoint. Once connected, you can generate quizzes, lesson plans, and flashcards by issuing high-level requests through the MCP client without needing to manage the underlying AI calls yourself.

How to install

# Prerequisites
- Python 3.8+
- Git (optional but recommended)

# Step 1: Set up a workspace
# Create a directory for EduChain MCP Server
mkdir -p ~/educhain-mcp-server
cd ~/educhain-mcp-server

# Step 2: Set up a Python virtual environment
python -m venv venv
# On Windows, use: .\venv\Scripts\activate
# On macOS/Linux, use: source venv/bin/activate

# Step 3: Install dependencies
pip install mcp httpx educhain

# Step 4: Run the MCP Server
python mcp_educhain_server.py
```

Note: If you use Windows with Claude Desktop, you may run commands exactly as shown above, adjusting paths to your environment. You will see the server start and listen for MCP requests from Claude Desktop.

Configuration and usage notes

Configure Claude Desktop to load EduChain MCP Server by pointing it to the local Python runtime and the server script. The configuration snippet below demonstrates how Claude Desktop should start the server process from a Windows user profile. Replace <YourUsername> with your actual username.

{
  "mcpServers": {
    "EduChainServer": {
      "command": "C:\\Users\\<YourUsername>\\Desktop\\educhain-mcp-server\\venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\<YourUsername>\\Desktop\\educhain-mcp-server\\mcp_educhain_server.py"],
      "env": {
        "PYTHONPATH": "C:\\Users\\<YourUsername>\\Desktop\\educhain-mcp-server"
      }
    }
  }
}
```

Replace <YourUsername> with your actual Windows username.

Examples of what you can do

Use simple requests through your MCP client to generate content. For example, you can ask for five multiple-choice questions on Python loops, request a lesson plan for algebra, or generate five HTML-based flashcards on Python programming basics. The responses are handled by the EduChain MCP Server and surfaced in Claude Desktop for immediate use in teaching materials.

Security and troubleshooting

Keep your server and dependencies up to date. Run the server in a secure, private environment if you are using sensitive data. If you encounter connection issues, verify that Claude Desktop is configured to point to the correct Python executable and script path, and ensure the environment variable PYTHONPATH correctly references the EduChain MCP Server directory.

Notes on features and limitations

The EduChain MCP Server provides three core capabilities: multiple-choice questions, lesson plans, and HTML-based flashcards. Remember that flashcard rendering is experimental and may require manual HTML handling if you encounter rendering limitations in certain clients.

Project status and status checks

The server is designed to run locally via stdio, with a Python-based runtime, and uses the Grok free-tier LLM for generation. Ensure you follow the setup steps to confirm successful operation in your environment.

mcq

Generates multiple-choice questions with options, correct answers, and explanations.

lesson_plans

Produces structured lesson plans suitable for teaching algebra or programming concepts.

flashcards

Generates HTML-based flashcards for quick study sessions.