SUSHI Test Manager MCP Server

SUSHI試験管理システム用のMCP（Model Context Protocol）サーバーです。

インストール

npm install
npm run build

使用方法

環境変数

• SUSHI_URL: LaravelアプリケーションのURL（デフォルト: http://localhost:8000）
• SUSHI_TOKEN: APIキー（必須）
• SUSHI_INSECURE: 自己署名証明書を許可するか（開発環境用、デフォルト: false）
  • true に設定すると、HTTPS接続時に自己署名証明書を許可します
  • 本番環境では使用しないでください

Cursorの設定

mcp.jsonに以下を追加：

{
  "mcpServers": {
    "SUSHI": {
      "command": "npx",
      "args": [
        "-y",
        "sushi-test-manager-mcp-server"
      ],
      "env": {
        "SUSHI_URL": "https://your-domain.com",
        "SUSHI_TOKEN": "your-api-key-here",
        "SUSHI_INSECURE": "false"
      }
    }
  }
}

ローカル開発

npm run dev

動作確認テスト

APIエンドポイントが正しく動作するかテストできます：

cd packages/mcp-server

# 環境変数を設定してテスト実行
SUSHI_URL="http://localhost:8000" SUSHI_TOKEN="your-api-key-here" npm test

または：

export SUSHI_URL="http://localhost:8000"
export SUSHI_TOKEN="your-api-key-here"
npm test

テスト内容：

• ✅ 試験項目一覧取得
• ✅ 試験項目作成
• ✅ 試験項目詳細取得
• ✅ 試験項目更新
• ✅ 試験項目削除

利用可能なツール

list_test_items

試験項目の一覧を取得します。APIキーに紐づくプロジェクトの試験項目のみ取得されます。

パラメータ:

• search (string, オプション): 検索キーワード
• type (string, オプション): 種類でフィルタ
• per_page (number, オプション): 1ページあたりの件数（デフォルト: 20、最大: 100）

get_test_item

特定の試験項目の詳細を取得します。

パラメータ:

• id (number, 必須): 試験項目ID

create_test_item

新しい試験項目を作成します（重複チェック付き）。APIキーに紐づくプロジェクトに自動的に追加されます。

パラメータ:

• type (string, 必須): 種類（正常系、異常系、境界値、性能、セキュリティ、UI/UX、その他）
• title (string, 必須): 概要（タイトル）
• steps (string, 必須): 操作手順
• expected_result (string, 必須): 期待結果
• preconditions (string, オプション): 前提条件
• notes (string, オプション): 備考
• tags (array, オプション): タグIDの配列
• force (boolean, オプション): 重複チェックをスキップするか（デフォルト: false）

注意: project_idは不要です。APIキーに紐づくプロジェクトが自動的に使用されます。

update_test_item

既存の試験項目を更新します。

パラメータ:

• id (number, 必須): 試験項目ID
• type (string, オプション): 種類
• title (string, オプション): 概要（タイトル）
• preconditions (string, オプション): 前提条件
• steps (string, オプション): 操作手順
• expected_result (string, オプション): 期待結果
• notes (string, オプション): 備考
• tags (array, オプション): タグIDの配列

delete_test_item

試験項目を削除します。

パラメータ:

• id (number, 必須): 試験項目ID

list_test_views

試験ビューの一覧を取得します。APIキーに紐づくプロジェクトの試験ビューのみ取得されます。

パラメータ:

• search (string, オプション): 検索キーワード
• status (string, オプション): ステータスでフィルタ
• per_page (number, オプション): 1ページあたりの件数（デフォルト: 20、最大: 100）

get_test_view

特定の試験ビューの詳細を取得します。

パラメータ:

• id (number, 必須): 試験ビューID

list_tags

タグの一覧を取得します。APIキーに紐づくプロジェクトのタグのみ取得されます。

パラメータ:

• search (string, オプション): 検索キーワード
• sort_by (string, オプション): ソート項目（usage_count, name, created_at、デフォルト: usage_count）
• sort_order (string, オプション): ソート順（asc, desc、デフォルト: desc）
• per_page (number, オプション): 1ページあたりの件数（デフォルト: 20、最大: 100）

get_tag

特定のタグの詳細を取得します。

パラメータ:

• id (number, 必須): タグID

ビルド

npm run build

公開

初回公開手順

cd packages/mcp-server

# npmにログイン（初回のみ、またはログインしていない場合）
npm login

# 依存関係のインストール
npm install

# TypeScriptをビルド
npm run build

# npmに公開
npm publish

更新手順

cd packages/mcp-server

# バージョンを更新（package.jsonのversionを更新）
# 例: "1.0.0" → "1.0.1"

# ビルド
npm run build

# 公開
npm publish

注意事項

• スコープなしパッケージなので、--access public は不要です
• 初回公開後は、npm publish だけで更新できます