Skip to main content
Glama

AIO Tests MCP Server

CI License: MIT Python 3.10+ MCP

AIO Tests(Jira 用テスト管理)向けのオープンソース MCP サーバーです。

Claude、Claude Code、Cursor、VS Code、Windsurf、その他の MCP クライアントを Jira のテストケースに接続できます。検索・閲覧、プロジェクトのフィールドスキーマの確認、フォルダツリーの参照、Classic および BDD のケースの作成・更新を、通常の会話形式で行えます。

Jira Cloud および Jira Server / Data Center に対応しています。セルフホスト型なので、認証情報やテストデータがインフラの外に出ることはありません。

uvx aio-tests-mcp-server

まだ PyPI には公開していません。 上記の uvx コマンドは最初のリリースで有効になります。 それまでは ソースから実行 をご利用ください。コマンドは2つだけです。

存在理由。 公式の AIO Tests MCP サーバーはクローズドソースで、リモートホスト型サービスであり、テナント固有の URL と Cloud のみのサポートです。これはセルフホスト可能で監査可能です。すべての行を読み、フォークし、自社ネットワーク内で実行できます。私の知る限り、Jira Server / Data Center をサポートする唯一の AIO Tests MCP サーバーであり、読み取り専用モードを備えているため、本番インスタンスに AI を安全に向けることができます。


ツール

すべて Jira プロジェクトにスコープされた10個のツールです。

ツール

アクセス

説明

aio_get_project

読み取り

プロジェクトで AIO Tests が有効かどうかを確認し、その ID を取得します

aio_get_test_case_schema

読み取り

フィールド、カスタムフィールド、必須フィールド、許可される値を取得します

aio_search_test_cases

読み取り

タイトル、キー、フォルダ、ステータス、優先度、タイプ、タグ、所有者、対象の Jira 課題、自動化ステータス/キー、作成・更新日でフィルタリングします

aio_get_test_case

読み取り

すべてのステップを含む完全なケース詳細を取得します

aio_get_test_case_versions

読み取り

ケースの保存済みバージョンをすべて取得します

aio_create_test_case

書き込み

Classic または BDD ステップでケースを作成します

aio_update_test_case

書き込み

フィールド、ステップ、メタデータ、優先度、ステータス、タグを更新します

aio_get_folder_hierarchy

読み取り

テストケース、サイクル、セットのフォルダツリー(またはフルパスのフラットリスト)を取得します

aio_create_folder

書き込み

フォルダを作成し、パスに沿って存在しない親フォルダも作成します

aio_get_tags

読み取り

プロジェクトに設定されたすべてのタグを取得します

ルックアップフィールドは名前または ID を受け付けます。 "Critical" の代わりに 4 と言うことも、フォルダ ID の代わりに /Regression/Checkout と言うこともできます。値はプロジェクト設定に対して解決されるため、モデルは AIO Tests UI で見るのと同じ語彙で動作します。

更新は書式を保持します。 ケースの更新はリッチテキストを有効にしたドキュメントを往復するため、触れていないフィールドの書式は維持され、プレーンテキスト入力はそれに合わせてエスケープされます。


Related MCP server: MCP Zephyr Scale Cloud Server

クイックスタート

1. アクセストークンを取得する

Jira Cloud — Jira で AIO Tests → (?) アイコン → API Access Token を開き、トークンを生成します。トークンはテナントを識別するため、URL は不要です。

Jira Server/Data Center — AIO Tests API は Jira のベース URL から提供され、Jira の認証情報(Personal Access Token、またはユーザー名 + パスワード)を再利用します。

2. MCP クライアントに追加する

{
  "mcpServers": {
    "aio-tests": {
      "command": "uvx",
      "args": ["aio-tests-mcp-server"],
      "env": {
        "AIO_API_TOKEN": "your_aio_access_token"
      }
    }
  }
}
{
  "mcpServers": {
    "aio-tests": {
      "command": "uvx",
      "args": ["aio-tests-mcp-server"],
      "env": {
        "AIO_ENABLED": "true",
        "JIRA_URL": "https://jira.your-company.com",
        "JIRA_PERSONAL_TOKEN": "your_personal_access_token"
      }
    }
  }
}

上記と同じ JSON を、クライアントの MCP 設定ファイル(Cursor では ~/.cursor/mcp.json、VS Code では .vscode/mcp.json)に記述します。Cursor はプロジェクトローカルの mcp.json も受け付けます。

Claude Code では、1つのコマンドで追加できます。

claude mcp add aio-tests --env AIO_API_TOKEN=your_token -- uvx aio-tests-mcp-server

3. 何か依頼する

"PROJ で /Regression/Checkout 内の smoke タグが付いた公開済みテストケースを検索して、最初のケースのステップを表示して。"

"PROJ-142 を読んで、受け入れ基準をカバーする BDD テストケースを作成して。"


設定

すべての設定は環境変数です。完全なリストは .env.example を参照してください。基本は次のとおりです。

変数

目的

AIO_API_TOKEN

AIO Tests アクセストークン(Cloud)。これを設定するだけでサーバーが有効になります。

AIO_ENABLED

Server/Data Center モードを有効にするには true に設定します。

JIRA_URL

Jira のベース URL(Server/DC)。

JIRA_PERSONAL_TOKEN

Jira PAT(Server/DC)、または JIRA_USERNAME + JIRA_API_TOKEN を使用します。

READ_ONLY_MODE

true にするとすべての書き込みツールが非表示になります。本番環境での使用を推奨します。

ENABLED_TOOLS

カンマ区切りのツール名の許可リスト。

AIO_URL

API のベース URL を上書きします。

AIO_SSL_VERIFY

証明書検証をスキップするには false(テスト専用)。

プロキシ設定(AIO_HTTP_PROXY、AIO_HTTPS_PROXY、AIO_SOCKS_PROXY、AIO_NO_PROXY)、クライアント証明書、カスタムヘッダーもサポートされています。

同じオプションは CLI フラグとしても利用できます。

uvx aio-tests-mcp-server --help

読み取り専用モード

本番 Jira に AI を向ける場合、参照のみにしたいでしょう。

uvx aio-tests-mcp-server --read-only

書き込みツールはツールリストから完全に非表示になるため、モデルはそれらを認識しません。


HTTP トランスポート

共有またはコンテナ化されたデプロイメントでは、stdio の代わりに Streamable HTTP で実行します。

uvx aio-tests-mcp-server --transport streamable-http --port 8000

サーバーは /mcp と、Kubernetes プローブ用の /healthz エンドポイントを公開します。

マルチテナント利用

1つのサーバーインスタンスで複数のユーザーにサービスを提供できます。各クライアントはリクエストごとに独自の AIO Tests トークンを送信し、リクエストはそのテナントにスコープされます。

{
  "mcpServers": {
    "aio-tests": {
      "url": "https://aio-mcp.your-company.com/mcp",
      "headers": {
        "X-Aio-Api-Token": "the_users_own_token"
      }
    }
  }
}

Authorization: Token <token> は X-Aio-Api-Token ヘッダーと同等に機能します。


ソースから実行

git clone https://github.com/AmirhosseinHanifehzadeh/aio-tests-mcp.git
cd aio-tests-mcp
uv sync
cp .env.example .env   # then fill it in
uv run aio-tests-mcp-server

テストを実行します。

uv run pytest

制限事項

  • フォルダの名前変更、移動、削除は実装されていません。 AIO Tests の公開 API にはそれらのエンドポイントがありません。

  • テストサイクルとテスト実行はまだカバーされていません。 現在のツールセットはテストケース管理(ケース、フォルダ、タグ、プロジェクトスキーマ)にスコープされています。貢献を歓迎します。


FAQ

これは公式の AIO Tests MCP サーバーですか? いいえ。AIO Tests は独自の MCP サーバーをホスト型サービスとして公開しています。クローズドソースで、テナント固有の URL を持ち、Cloud のみです。これは独立したオープンソース実装であり、自分で実行します。AIO Tests や Atlassian とは提携・承認されていません。

Jira Data Center や Jira Server で動作しますか? はい。AIO_ENABLED=true と JIRA_URL を設定し、Jira Personal Access Token またはユーザー名とパスワードで認証します。Server/DC では AIO Tests API は Jira のベース URL から提供されるため、Jira の認証情報を再利用します。これが代替サーバーよりもこのサーバーを選ぶ主な理由です。ホスト型は Cloud のみです。

Claude Code、Claude Desktop、Cursor、VS Code で使えますか? はい。任意の MCP クライアントで動作します。貼り付け可能な設定は MCP クライアントに追加する を参照してください。

本番 Jira に向けても安全ですか? --read-only(または READ_ONLY_MODE=true)で実行してください。書き込みツールはツールリストから完全に除外されるため、モデルは作成や更新が可能であることを認識しません。

認証情報はどこに送信されますか? あなた自身のマシンと Jira インスタンス以外には送信されません。サーバーはデフォルトで stdio 経由でローカルに実行され、AIO Tests REST API と直接通信します。仲介サービスはありません。

1つのサーバーインスタンスでチーム全体にサービスを提供できますか? はい。HTTP で実行し、各クライアントが X-Aio-Api-Token ヘッダーで独自のトークンを送信します。マルチテナント利用 を参照してください。

テストサイクル、実行、添付ファイルはサポートされていますか? まだです。現在のツールセットはテストケース管理(ケース、フォルダ、タグ、プロジェクトスキーマ)をカバーしています。サイクルと実行は明らかに次のステップです。制限事項 を参照してください。課題も歓迎します。


貢献

課題とプルリクエストを歓迎します。CONTRIBUTING.md を参照してください。テストスイートはクライアント、設定解決、すべてのミックスイン、すべてのツールをカバーしています。グリーンを維持し、新しい動作にはケースを追加してください。

ライセンス

MIT。

このプロジェクトの一部は、@sooperset による mcp-atlassian(同じく MIT ライセンス)から派生しています。基盤に感謝します。

このプロジェクトは AIO Tests や Atlassian とは提携・承認されていません。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for Jira Cloud tailored for ALM projects with Zephyr Scale integration, enabling issue management, sprint tracking, and test step operations.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-compatible clients to directly manage Jira Requirements and Test Management resources such as requirements, test cases, plans, executions, defects, tree structures, and automation via exposed tools.
      4 npm
      MIT