AIO MCP Server

AIO MCP Server

Jira AIO（All-in-One）テストケース管理システムとやり取りするための Model Context Protocol（MCP）サーバーです。

機能

• AIO からテストケースの詳細を取得
• プロジェクトやフォルダーでテストケースを検索
• プロジェクトのフォルダー構造を取得
• AIO のすべてのプロジェクトの一覧を取得
• テストケースの作成と更新（タイトル、説明、事前条件、手順、ステータス、優先度）
• ケースの作成時に Jira 課題を要件としてリンク
• フォルダーとサブフォルダーを作成

前提条件

• Node.js 18+
• AIO Tests を含む Jira インスタンスへのアクセス
• Jira API トークン

インストール

1. リポジトリをクローンします
2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

npm run build の実行後、Cursor で jira-aio MCP サーバーを再起動します（Settings → MCP → Restart）。Cursor は build/index.js を自動的に再読み込みしません。

設定

サーバーは mcp.json から JIRA_URL と JIRA_TOKEN を読み込みます：

• ~/.cursor/mcp.json
• またはプロジェクトルートにある mcp.json

例：

{
  "mcpServers": {
    "jira-aio": {
      "command": "node",
      "args": ["C:/path/to/jira-aio-mcp-server/build/index.js"],
      "env": {
        "JIRA_URL": "https://your-jira-instance:port",
        "JIRA_TOKEN": "your-jira-token"
      }
    }
  }
}

• JIRA_URL：必要に応じてポートを含む Jira のベース URL
• JIRA_TOKEN：Jira の個人用アクセストークン（Bearer）

利用可能なツール

1. get_aio_testcase

特定のテストケースの詳細情報を取得します。

• projectKey：プロジェクトキー（例：BON、MSG）
• testCaseKey：テストケースキー（例：BON-TC-170）

2. search_aio_testcase

プロジェクト内のテストケースを検索します。フォルダーは任意で指定できます。

• projectId：数値形式の Jira/AIO プロジェクト ID（例：11800）
• folderIds：フォルダー ID の配列（省略可）

3. get_aio_folders

プロジェクトのフォルダーツリーを取得します。

• projectId：数値形式のプロジェクト ID（例：11800）

4. get_aio_projects

トークンで利用できる Jira プロジェクトの一覧を表示します。

• パラメーターなし

5. update_case

渡したフィールドのみを更新します。それ以外のフィールドは変更されません。レスポンスには以前の値（特に手順）を含む rollback が含まれます。

• projectKey、testCaseKey — 必須
• title
• description — 空文字列を指定するとフィールドをクリアします
• precondition — 空文字列を指定するとフィールドをクリアします
• status — Draft、Under Review、Published、Deprecated、Not integrated（ID はプロジェクト設定から読み込みます）
• priority — Critical、High、Medium、Low、Lowest（ID はプロジェクト設定から読み込みます）
• steps — 手順の全リスト：{ id?, step, expectedResult, data? }。既存の手順を更新するには id を渡します。元に戻すには、前のレスポンスの rollback.steps を送信します。

説明、事前条件、手順に含まれる通常の URL は、クリック可能な HTML リンクに変換されます。

6. create_case

テストケースを作成します。手順と Jira の要件は、AIO UI と同様に、ケース本体の作成後に保存されます。

• projectKey、title — 必須
• folderId または folder — フォルダー ID、名前、またはパス（例：8616 または не актуально / тесты）
• description、precondition
• status — 既定値は Draft
• priority
• steps — [{ step, expectedResult, data? }]
• requirements — Jira キーまたは ID（例：["BON-1642"]）

ステータス、優先度、カスタムフィールドの ID は、対象プロジェクトの AIO 設定から取得されます。他のプロジェクトに BON の ID をハードコードしないでください。

7. create_folder

フォルダーまたはサブフォルダーを作成します。

• projectKey、name — 必須
• parentId または parent — 親フォルダーの ID、名前、またはパス。プロジェクトのルートに作成する場合は省略します。

注意事項

• ステータスと優先度の ID はプロジェクトによって異なります（BON の Draft は 61、MSG の Draft は 49）。
• update_case は現在、タグ、ケースタイプ、見積もり工数、カスタムフィールドを変更しません。
• コードを変更した後は、npm run build を実行し、Cursor で MCP jira-aio を再起動します。

エラー処理

サーバーは以下に対応します：

• API リクエストの失敗
• 認証の問題
• 無効な設定
• 必須パラメーターの不足

セキュリティ

• Bearer トークン認証
• HTTPS に対応
• トークンはリポジトリではなく、mcp.json または環境変数に設定してください

開発

npm run build
npm test
npm run lint

スタック：TypeScript、Model Context Protocol SDK、Axios。