TestRail MCP サーバー

標準化されたプロトコルを通じて TestRail のコア エンティティとの対話を可能にする、TestRail 用の Model Context Protocol (MCP) サーバー。

特徴

• TestRail API による認証
• TestRail エンティティへのアクセス:
  • プロジェクト
  • 事例
  • ラン
  • 結果
  • データセット
• モデルコンテキストプロトコルの完全サポート
• あらゆる MCP クライアント (Claude Desktop、Cursor、Winsurf など) と互換性があります

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の testrail-mcp を自動的にインストールするには:

手動インストール

1. このリポジトリをクローンします:
   git clone https://github.com/yourusername/testrail-mcp.git cd testrail-mcp
2. 仮想環境を作成してアクティブ化します。
   python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. 依存関係をインストールします:
   pip install -e .

構成

TestRail MCP サーバーは、TestRail インスタンスの認証に特定の環境変数を必要とします。これらの環境変数は、サーバーを実行する前に設定する必要があります。

1. プロジェクトのルート ディレクトリに.envファイルを作成します。
   TESTRAIL_URL=https://your-instance.testrail.io TESTRAIL_USERNAME=your-email@example.com TESTRAIL_API_KEY=your-api-key
   重要な注意事項:
   • TESTRAIL_URL 、TestRail インスタンスへの完全な URL である必要があります (例: https://example.testrail.io )
   • TESTRAIL_USERNAMEはログインに使用するTestRailのメールアドレスです
   • TESTRAIL_API_KEYは TestRail API キーです (パスワードではありません)
     • APIキーを生成するには、TestRailにログインし、「マイ設定」>「APIキー」に移動して新しいキーを作成します。
2. 構成が正しくロードされていることを確認します。
   python -c "from testrail_mcp.config import TESTRAIL_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY; print(f'URL: {TESTRAIL_URL}, Username: {TESTRAIL_USERNAME}, API Key: {TESTRAIL_API_KEY[:5]}...')"
   これにより、TestRail の URL、ユーザー名、API キーの最初の数文字が出力されます。

Claude DesktopやCursorなどのクライアントでこのサーバーを使用している場合は、サーバーを実行しているプロセスが環境変数にアクセスできることを確認してください。これらの変数をシステム環境で設定するか、 .envファイルから読み込まれるようにする必要があるかもしれません。

使用法

サーバーの実行

サーバーは Python モジュールとして直接実行できます。

これにより、MCP サーバーが stdio モードで起動され、stdio 通信をサポートする MCP クライアントで使用できるようになります。

MCPクライアントでの使用

クロードデスクトップ

1. クロードデスクトップを開く
2. 設定 > サーバーへ移動
3. 「サーバーをインストール」をクリックします
4. プロジェクトディレクトリに移動します
5. Pythonモジュールを選択します: testrail_mcp
6. Claude DesktopはTestRail MCPサーバーを使用できるようになりました

カーソル

1. オープンカーソル
2. 設定 > AI > カスタムツールに移動します
3. 「ツールを追加」をクリック
4. ツールを設定します。
   • 名前: TestRail MCP
   • コマンド: python -m testrail_mcp
   • 通信: Stdio
5. 設定を保存する

ウィンサーフ

1. ウィンサーフを開く
2. 設定 > ツールに移動
3. 「ツールを追加」をクリック
4. ツールを設定します。
   • 名前: TestRail MCP
   • コマンド: python -m testrail_mcp
   • プロトコル: MCP
5. 設定を保存する

MCP Inspectorによるテスト

テストとデバッグには、MCP Inspector を使用できます。

これにより、利用可能なすべてのツールとリソースを調べてテストできる Web インターフェイスが開きます。

発達

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

• FastMCP - MCP サーバーを構築するための Python フレームワーク
• リクエスト- TestRail API との HTTP 通信用
• python-dotenv - 環境変数管理用

ライセンス

マサチューセッツ工科大学