userinyerface-mcp-server

一个小型 MCP（Model Context Protocol）服务器，将 userinyerface.com 毕业项目（第 4 单元 — Allure 与报告）的官方测试用例以 MCP 工具的形式暴露出来。

该项目的测试用例不包含在练习仓库中。就像在真实项目中一样，它们存放在一个独立的测试用例管理系统中——在这里，该系统就是这个 MCP 服务器。将你的 AI 客户端连接到它，并在毕业任务第 0 阶段获取你需要的测试用例。

它提供什么

两个工具，由同一个 test_cases.json 文件支撑：

• list_test_cases() — 返回每个可用测试用例的 id 和标题（TC1 Cards、TC2 Help Form、TC3 Cookies Form、TC4 Timer）。

• get_test_case(test_id) — 返回指定 id 的完整测试用例：host、前置条件以及分步表格（操作 / 预期结果）。

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 助手询问类似 "列出可用的测试用例" 或 "给我 TC4 的测试用例" 来确认它正常工作。

完整操作演示请参阅第 4 单元设置视频。

项目结构

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