MCP

🚀 Testomat.io MCP Server

Testomat.io APIをCursorのようなAIアシスタントと統合するためのモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

このセクションでは、Testomat.io MCP Serverのインストールと使用方法について説明します。

📦 インストール

前提条件

• Node.js 18以上（組み込みのfetchサポート付き）
• npmまたはyarnパッケージマネージャー
• APIアクセス権を持つTestomat.ioアカウント

npmを使ったインストール

npm install -g @testomatio/mcp

npxで直接実行する場合

npx @testomatio/mcp --token <your-token> --project <project-id>

💻 使用例

コマンドラインオプション

MCPサーバーは、コマンドライン引数または環境変数を使用して起動できます。

コマンドライン引数を使用する場合

# 短いフラグを使用
npx @testomatio/mcp -t testomat_YOUR_TOKEN_HERE -p your-project-id

# 長いフラグを使用
npx @testomatio/mcp --token testomat_YOUR_TOKEN_HERE --project your-project-id

# グローバルにインストールした場合
testomatio-mcp --token testomat_YOUR_TOKEN_HERE --project your-project-id

# カスタムベースURLを指定する場合
npx @testomatio/mcp --token testomat_YOUR_TOKEN_HERE --project your-project-id --base-url https://your-instance.testomat.io

環境変数を使用する場合

# 環境変数を設定
export TESTOMATIO_API_TOKEN=testomat_YOUR_TOKEN_HERE
export TESTOMATIO_BASE_URL=https://app.testomat.io  # オプション、デフォルトはhttps://app.testomat.io

# プロジェクトIDを指定して実行
npx @testomatio/mcp --project your-project-id

# または環境変数を直接指定して実行
TESTOMATIO_API_TOKEN=testomat_YOUR_TOKEN_HERE npx @testomatio/mcp --project your-project-id

APIトークンの取得方法

1. Testomat.ioにアクセスします。
2. ユーザートークンのページhttps://app.testomat.io/account/access_tokens に移動します。
3. General API token（testomat_で始まる）を作成し、コピーします。

プロジェクトIDの取得方法

プロジェクトを表示しているときのURLにプロジェクトIDが含まれています。

https://app.testomat.io/projects/YOUR_PROJECT_ID

Cursorとの統合

このMCPサーバーをCursorと連携するには、Cursorの設定に以下の構成を追加します。

オプション1: npxを使用する（推奨）

CursorのMCP設定（cursor-settings.jsonまたはCursorの設定UIを通じて）に以下を追加します。

{
  "mcpServers": {
    "testomatio": {
      "command": "npx",
      "args": ["@testomatio/mcp", "--token", "testomat_YOUR_TOKEN_HERE", "--project", "YOUR_PROJECT_ID"]
    }
  }
}

オプション2: 環境変数を使用する

まず、シェルプロファイル（.bashrc, .zshrcなど）で環境変数を設定します。

export TESTOMATIO_API_TOKEN=testomat_YOUR_TOKEN_HERE

次に、CursorのMCP設定に以下を追加します。

{
  "mcpServers": {
    "testomatio": {
      "command": "npx",
      "args": ["@testomatio/mcp", "--project", "YOUR_PROJECT_ID"],
      "env": {
        "TESTOMATIO_API_TOKEN": "testomat_YOUR_TOKEN_HERE"
      }
    }
  }
}

オプション3: グローバルインストール

パッケージをグローバルにインストールした場合、以下の設定を使用します。

{
  "mcpServers": {
    "testomatio": {
      "command": "testomatio-mcp",
      "args": ["--token", "testomat_YOUR_TOKEN_HERE", "--project", "YOUR_PROJECT_ID"]
    }
  }
}

✨ 主な機能

ツール

テスト

• get_tests – すべてのテストを取得します（パラメータ: plan, query, state, suite_id, tag, labels） — API: GET /tests
• search_tests – テストを検索します（パラメータ: query, tql, labels, state, priority, filter, page） — API: GET /tests

テストスイート

• search_suites – スイートを検索します（パラメータ: query, labels, state, priority, page） — API: GET /suites
• get_root_suites – ルートレベルのスイートを一覧表示します（パラメータなし） — API: GET /suites
• get_suite – 1つのスイートを取得します（パラメータ: suite_id） — API: GET /suites/{suite_id}

テスト実行

• get_runs – すべての実行を一覧表示します（パラメータなし） — API: GET /runs
• get_run – 1つの実行を取得します（パラメータ: run_id, tree） — API: GET /runs/{run_id}
• get_testruns – テストの実行を取得します（パラメータ: test_id, finished_at_date_range） — API: GET /testruns

テストプラン

• get_plans – すべてのプランを一覧表示します（パラメータ: detail, labels, page） — API: GET /plans
• get_plan – 1つのプランを取得します（パラメータ: plan_id） — API: GET /plans/{plan_id}

💻 使用例

基本的な使用法

設定が完了すると、AIアシスタントに以下のような質問をすることができます。

• "Show me all the tests in the project"
• "Get the test runs for test ID abc123"
• "What are the root suites in this project?"
• "Show me details for test run xyz789"
• "List all automated tests with the @smoke tag"
• "Get all test plans for this project"

クエリパターン

基本情報クエリ

これらのクエリは、特定のフィルタリングなしで一般的な情報を取得します。

• "Show me all the tests in the project" → get_testsツール
• "What are the root suites in this project?" → get_root_suitesツール
• "Get all test runs" → get_runsツール
• "Get all test plans for this project" → get_plansツール

特定アイテムクエリ

これらのクエリは、IDで特定のエンティティを対象とします。

• "Get test runs for test ID abc123" → get_testrunsツール（test_id: "abc123"）
• "Show me details for test run xyz789" → get_runツール（run_id: "xyz789"）
• "Get suite details for suite-456" → get_suiteツール（suite_id: "suite-456"）

検索とフィルタリングクエリ

これらのクエリは、高度なフィルタリング機能を使用します。

• "List all automated tests with the @smoke tag" → search_testsツール（query: "@smoke", state: "automated"）
• "Find tests with priority high" → search_testsツール（priority: "high"）
• "Search for tests containing 'login'" → search_testsツール（query: "login"）
• "List tests tagged @critical or labelled 'ux' with high priority" → search_testsツール（tql: "tag == 'critical' or label == 'ux' and priority == 'high'"）
• "Find tests linked to JIRA-123" → search_testsツール（tql: jira == 'BDCP-2'）

高度なクエリ構文

テストクエリ言語（TQL）

search_testsツールは、複雑なフィルタリングのためにTQLをサポートしています。

"tag == 'smoke' and state == 'manual'"
"priority == 'high' or label == 'ux'"

タグベースの検索

タグは@プレフィックスを使用して検索できます。

@smoke        # 'smoke'タグ付きのテスト
@regression   # 'regression'タグ付きのテスト
@critical     # 'critical'タグ付きのテスト

Jira統合

Jiraの問題にリンクされたテストは、問題キーを使用して見つけることができます。

JIRA-123      # JIRA-123にリンクされたテスト
PROJ-456      # PROJ-456にリンクされたテスト

🔧 トラブルシューティング

一般的な問題

1. "API token is required"エラー
   • トークンがtestomat_で始まっていることを確認してください。
   • Testomat.ioプロジェクト設定のトークンが正しいことを確認してください。
2. "Project ID is required"エラー
   • 正しいプロジェクトIDを渡していることを確認してください。
   • プロジェクトIDが存在し、アクセス権があることを確認してください。
3. 接続エラー
   • インターネット接続があることを確認してください。
   • ファイアウォールがapp.testomat.ioへの接続を許可していることを確認してください。
   • APIトークンに必要な権限があることを確認してください。
4. CursorでMCPサーバーが起動しない場合
   • CursorのMCPログを確認してエラーメッセージを確認してください。
   • Node.js 18以上がインストールされ、アクセス可能であることを確認してください。
   • まず手動でコマンドを実行してテストしてみてください。

デバッグモード

サーバーを実行するときに詳細なログを表示するには、以下のコマンドを使用します。

DEBUG=* npx @testomatio/mcp --token <token> --project <project-id>

📚 ドキュメント

Testomat.io APIの詳細情報については、Testomat.io API Documentationを参照してください。

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

🆘 サポート

サポートが必要な場合は、以下の手順を試してください。

1. Testomat.io Documentationを確認します。
2. GitHubでイシューを作成します。
3. Testomat.ioサポートに連絡します。

📝 変更履歴

v1.0.0

• 初期リリース
• すべての主要なTestomat.io APIエンドポイントをサポート
• MCP互換のツールインターフェイス
• LLM処理のためのセマンティックXML形式