userinyerface-mcp-server

userinyerface.com 캡스톤 프로젝트(Unit 4 — Allure & Reporting)의 공식 테스트 케이스를 MCP 도구로 노출하는 작은 MCP(Model Context Protocol) 서버입니다.

이 프로젝트의 테스트 케이스는 연습용 저장소에 포함되어 있지 않습니다. 실제 프로젝트와 마찬가지로 별도의 테스트 케이스 관리 시스템에 있습니다. 여기서 그 시스템은 바로 이 MCP 서버입니다. AI 클라이언트를 연결하고 캡스톤 작업의 Phase 0의 일부로 필요한 테스트 케이스를 가져오세요.

노출되는 기능

단일 test_cases.json 파일을 기반으로 하는 두 가지 도구:

• list_test_cases() — 사용 가능한 모든 테스트 케이스(TC1 Cards, TC2 Help Form, TC3 Cookies Form, TC4 Timer)의 ID와 제목을 반환합니다.

• get_test_case(test_id) — 지정된 ID에 대한 전체 테스트 케이스를 반환합니다: host, preconditions, 그리고 단계별 테이블(action / expected result).

Related MCP server: mcp-playwright-test

설정

Python 3.10+가 필요합니다.

pip install -r requirements.txt

다음과 같이 서버가 로컬에서 실행되는지 확인할 수 있습니다:

python server.py

(stdio에서 대기 상태로 머무를 것입니다. 이는 정상입니다. 중지하려면 Ctrl+C를 누르세요. 수동으로 실행할 필요는 없습니다. MCP 클라이언트가 자동으로 실행합니다.)

Cursor(무료 티어)로 연결하기

1. Cursor → Settings → MCP를 엽니다.

2. 다음과 같은 구성으로 새 MCP 서버를 추가합니다(이 저장소를 클론한 경로로 조정하세요):

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

3. Cursor에 서버가 연결된 것으로 표시되고 list_test_cases 및 get_test_case 도구를 사용할 수 있어야 합니다.

4. AI 어시스턴트에게 "list the available test cases" 또는 *"get me the test case for TC4"*처럼 요청해서 작동하는지 확인하세요.

전체 안내는 Unit 4 설정 영상을 참조하세요.

프로젝트 구조

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