userinyerface-mcp-server

A small MCP (Model Context Protocol) server that exposes the official test cases for the userinyerface.com capstone project (Unit 4 — Allure & Reporting) as MCP tools.

The test cases for this project are not included in the practice repositories. Just like on a real project, they live in a separate test case management system — here, that system is this MCP server. Connect your AI client to it and retrieve the test cases you need as part of Phase 0 of the capstone task.

What it exposes

Two tools, backed by a single test_cases.json file:

• list_test_cases() — returns the id and title of every available test case (TC1 Cards, TC2 Help Form, TC3 Cookies Form, TC4 Timer).

• get_test_case(test_id) — returns the full test case for a given id: host, preconditions, and the step-by-step table (action / expected result).

Related MCP server: mcp-playwright-test

Setup

Requires Python 3.10+.

pip install -r requirements.txt

You can sanity-check the server runs locally with:

python server.py

(It will sit waiting on stdio — that's expected. Press Ctrl+C to stop. You don't need to run it manually; your MCP client launches it for you.)

Connecting via Cursor (free tier)

1. Open Cursor → Settings → MCP.

2. Add a new MCP server with a config like this (adjust the path to wherever you cloned this repo):

{
  "mcpServers": {
    "userinyerface-test-cases": {
      "command": "python",
      "args": ["/absolute/path/to/userinyerface-mcp-server/server.py"]
    }
  }
}

3. Cursor should show the server as connected, with list_test_cases and get_test_case available as tools.

4. Ask your AI assistant something like "list the available test cases" or "get me the test case for TC4" to confirm it's working.

See the Unit 4 setup video for a full walkthrough.

Project structure

userinyerface-mcp-server/
├── server.py          # MCP server entry point — tool definitions
├── test_cases.json    # The actual test case data
├── requirements.txt
└── README.md