AIO Tests MCP Server

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個のツールです。

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

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

Related MCP server: jira-aio-mcp-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_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 とは提携・承認されていません。