SUSHI Test Manager MCP Server

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

インストール

``bash
npm install
npm run build
`

使用方法

$3

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

$3

mcp.jsonに以下を追加：

`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"
}
}
}
}
`

$3

`bash
npm run dev
`

$3

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

`bash
cd packages/mcp-server

環境変数を設定してテスト実行


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

または：

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

テスト内容：
- ✅ 試験項目一覧取得
- ✅ 試験項目作成
- ✅ 試験項目詳細取得
- ✅ 試験項目更新
- ✅ 試験項目削除

利用可能なツール

$3

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

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

$3

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

パラメータ:
- id (number, 必須): 試験項目ID

$3

新しい試験項目を作成します（重複チェック付き）。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キーに紐づくプロジェクトが自動的に使用されます。

$3

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

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

$3

試験項目を削除します。

パラメータ:
- id (number, 必須): 試験項目ID

$3

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

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

$3

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

パラメータ:
- id (number, 必須): 試験ビューID

$3

タグの一覧を取得します。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）

$3

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

パラメータ:
- id (number, 必須): タグID

ビルド

`bash
npm run build
`

公開

$3

`bash
cd packages/mcp-server

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

npm login

依存関係のインストール

npm install

TypeScriptをビルド

npm run build

npmに公開

npm publish
`

$3

`bash
cd packages/mcp-server

バージョンを更新（package.jsonのversionを更新）

例: "1.0.0" → "1.0.1"

ビルド

npm run build

公開

npm publish
`

$3

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