Jira Aio MCP Server

🚀 AIO MCP サーバー

AIO MCP サーバーは、Jira AIO（All-in-One）テストケース管理システムとのモデルコンテキストプロトコル（MCP）を提供するサーバーです。このサーバーを使用することで、AIO テストケースの管理や検索が容易になります。

✨ 主な機能

• AIO テストケースの詳細情報を取得します。
• プロジェクトやフォルダーを指定してテストケースを検索します。
• プロジェクトのフォルダー構造を取得します。
• AIO 内のすべてのプロジェクトのリストを取得します。

📦 インストール

前提条件

• Node.js がインストールされていること。
• AIO テストケース管理システムがインストールされた Jira インスタンスへのアクセス権が必要です。
• Jira API トークンが必要です。

インストール手順

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

npm install

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

npm run build

📚 ドキュメント

設定

サーバーは mcp.json を使用して設定する必要があります。このファイルは以下のいずれかの場所に配置できます。

• ユーザーのホームディレクトリ: ~/.cursor/mcp.json
• プロジェクトのルートディレクトリ

mcp.json の設定例:

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

設定パラメータ

利用可能なツール

1. get_aio_testcase

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

• パラメータ:
  • projectKey: AIO 内のプロジェクトキー（例: "AT"）
  • testCaseKey: テストケースキー（例: "AT-TC-9"）

2. search_aio_testcase

プロジェクトや特定のフォルダー内でテストケースを検索します。

• パラメータ:
  • projectId: AIO 内のプロジェクト ID（例: 11502）
  • folderIds: （オプション）検索対象のフォルダー ID の配列

3. get_aio_folders

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

• パラメータ:
  • projectId: AIO 内のプロジェクト ID（例: 11502）

4. get_aio_projects

AIO 内のすべての利用可能なプロジェクトのリストを取得します。

• パラメータは不要です。

エラー処理

サーバーには包括的なエラー処理機能が備わっており、以下のようなエラーを処理します。

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

セキュリティ

• サーバーはベアラートークンを使用した認証をサポートしています。
• HTTPS 接続をサポートしています。
• 機密情報の設定は環境変数を通じて提供できます。

開発

このサーバーは以下の技術を使用して構築されています。

• TypeScript
• モデルコンテキストプロトコル SDK
• Axios（HTTP リクエスト用）