userinyerface-mcp-server

userinyerface.com キャップストーンプロジェクト（ユニット4 — Allure & Reporting）の公式テストケースをMCPツールとして公開する、小さなMCP（Model Context Protocol）サーバーです。

このプロジェクトのテストケースは、練習用リポジトリには含まれていません。実際のプロジェクトと同様に、テストケースは別のテストケース管理システムに格納されています。ここでは、そのシステムがこのMCPサーバーに相当します。AIクライアントを接続し、キャップストーンタスクのフェーズ0の一環として、必要なテストケースを取得してください。

公開内容

単一の test_cases.json ファイルに基づく、2つのツールを公開しています：

• list_test_cases() — 利用可能なすべてのテストケースのIDとタイトルを返します（TC1 Cards、TC2 Help Form、TC3 Cookies Form、TC4 Timer）。

• get_test_case(test_id) — 指定されたIDに対応する完全なテストケースを返します：ホスト、前提条件、およびステップごとの表（アクション / 期待される結果）。

Related MCP server: mcp-playwright-test

セットアップ

Python 3.10以上が必要です。

pip install -r requirements.txt

サーバーがローカルで正しく動作するか確認するには：

python server.py

（stdio上で待機状態になります — これは想定どおりです。停止するにはCtrl+Cを押してください。手動で実行する必要はありません。MCPクライアントが自動的に起動します。）

Cursor（無料版）での接続方法

1. Cursorを開き、設定 → 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