Testdino MCP

🚀 TestDino MCP

このModel Context Protocol (MCP)サーバーは、TestDinoとAIエージェントを接続します。このサーバーを使用すると、自然言語コマンドを通じて直接TestDinoのテストデータと対話することができます。

🚀 クイックスタート

このMCPサーバーは、TestDinoテスト管理プラットフォームとAIエージェントの間のギャップを埋めます。TestDinoのダッシュボードを手動で操作する代わりに、AIアシスタントに以下のことを依頼できます。

• テスト実行結果を確認する
• テストの失敗を分析する
• テスト結果をアップロードする
• 詳細なテストケース情報を取得する

すべてが簡単な会話形式のコマンドで可能です。

✨ 主な機能

• 🔍 ヘルスチェック：API接続を検証し、TestDino APIキーを検証します。
• 📊 テスト実行管理：強力なフィルタリングオプションでテスト実行の一覧を表示し、詳細情報を取得します。
• 🧪 テストケース分析：エラー、ログ、実行手順など、個々のテストケースの包括的な詳細を取得します。
• 📤 テストアップロード：ローカルマシンからPlaywrightのテスト結果を自動的にTestDinoにアップロードします。
• 🔌 MCP互換：Model Context Protocol標準に基づいて構築されています。任意のMCP互換のIDEやAIエージェントでTestDino MCPを構成できます。
• ⚡ 簡単なセットアップ：npxを使用して数分でインストールおよび構成できます。
• 🔐 セキュア：APIキーはローカル構成に安全に保存されます。

利用可能なツール

サーバーは6つの強力なツールを提供します。

1. health - 接続を検証し、APIキーを検証します。
2. list_testruns - フィルター（ブランチ、時間、作成者、コミット、環境）でテスト実行を閲覧します。
3. get_run_details - 特定のテスト実行の詳細情報を取得します。
4. list_testcase - 包括的なフィルタリング（テスト実行、ステータス、ブラウザ、エラーカテゴリ、ブランチ、環境、コミット、作成者など）でテストケースを一覧表示します。
5. get_testcase_details - 特定のテストケースの詳細情報を取得します。
6. upload_latest_local_test_runs - ローカルのPlaywrightテスト結果をアップロードします。

📦 インストール

インストールオプション

TestDino MCPを使用する主なオプションは主に3つあります。

オプション1: npxを使用する（推奨 - インストール不要）

• インストール不要
• 必要なときに自動的にダウンロードして実行
• 常に最新バージョンを使用
• 任意のMCP互換プラットフォームで構成可能

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

npm install -g testdino-mcp

• 一度インストールすれば、すべてのプロジェクトで使用可能
• Node.js 18+とnpmが必要
• コマンド: testdino-mcp

オプション3: プロジェクト内インストール

npm install testdino-mcp

• プロジェクトのnode_modulesにインストール
• コマンド: npx testdino-mcp

📚 ドキュメント

Cursor IDEの簡単な統合ガイド

ステップ1: APIキーを取得する

1. TestDinoアカウントにログインします。
2. 設定 → APIキーに移動します。
3. 新しいAPIキーを生成するか、既存のAPIキーをコピーします。

ステップ2: Cursorを構成する

1. MCP構成ファイルを開くまたは作成する：

   • Windows: %APPDATA%\Cursor\mcp.json
   • macOS/Linux: ~/.cursor/mcp.json
   • プロジェクト固有: プロジェクトルートの.cursor/mcp.json

2. npxを使用する場合またはプロジェクト内にインストールする場合、構成を追加する：

{
  "mcpServers": {
    "TestDino": {
      "command": "npx",
      "args": ["-y", "testdino-mcp"],
      "env": {
        "TESTDINO_API_KEY": "your_testdino_api_key_here"
      }
    }
  }
}

重要: your_testdino_api_key_hereをステップ1で取得した実際のAPIキーに置き換えてください。

ステップ3: 再起動して確認する

1. Cursorを完全に閉じて再起動する
2. 接続を確認する：「Check TestDino health」と尋ねる
3. すべてが正常に動作していれば、プロジェクト名とIDが表示されます！

代替案: グローバルインストール

npxやプロジェクト内インストールではなく、グローバルにインストールする場合：

npm install -g testdino-mcp

次に、この構成を使用します。

{
  "mcpServers": {
    "TestDino": {
      "command": "testdino-mcp",
      "env": {
        "TESTDINO_API_KEY": "your_testdino_api_key_here"
      }
    }
  }
}

サーバーは標準のMCPプロトコルを使用しているため、他のMCP互換クライアントでも動作します。

💻 使用例

構成が完了したら、自然言語でAIアシスタントに話しかけるだけです。重要: ツールを使用するには、mcp.jsonにTESTDINO_API_KEYを構成する必要があります。

コマンド例

CursorまたはClaude Desktop（または他のMCP互換クライアント）でこれらの自然言語コマンドを試してみてください。

接続とセットアップ:

• "TestDinoの接続が正常に動作しているか確認する"
• "TestDinoのAPIキーを検証する"

テスト実行の探索:

• "最後の5つのテスト実行を表示する"
• "developブランチにあるテスト実行はどれですか？"
• "過去3日間のテスト実行を一覧表示する"
• "作成者johnによるテスト実行を表示する"
• "コミットabc123のテスト実行を見つける"
• "本番環境のすべてのテスト実行を一覧表示する"

テスト結果の分析:

• "テスト実行test_run_6901b2abc6b187e63f536a6bの詳細を取得する"
• "カウンター42のテスト実行の詳細を取得する"
• "テスト実行test_run_6901b2abc6b187e63f536a6bで失敗したテストケースはどれですか？"
• "最後のテスト実行からすべての不安定なテストを表示する"
• "本番環境で失敗したすべてのテストケースを一覧表示する"
• "100秒以上かかったmainブランチのテストケースを表示する"
• "コミットabc123のテストケースですべてのタイムアウト問題を見つける"

結果のアップロード:

• "Playwrightのテスト結果をアップロードする"
• "./test-resultsディレクトリからテスト結果をアップロードする"

🔧 技術詳細

必要条件

• Node.js 18.0.0以上
• NPM（パッケージ管理用）