TestRail MCP サーバー

Name: TestRail MCP Server
Author: sker65

鍛冶屋のバッジ

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

特徴

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

Related MCP server: JMeter MCP Server

Octomind MCPと一緒に動作を確認してください

ビデオタイトル

インストール

Smithery経由でインストール

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

npx -y @smithery/cli install @sker65/testrail-mcp --client claude

手動インストール

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

構成

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

プロジェクトのルートディレクトリに.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キー」に移動して新しいキーを作成します。
構成が正しくロードされていることを確認します。
uvx testrail-mcp --config
これにより、URL、ユーザー名、検証用の API キーの最初の数文字など、TestRail 構成情報が表示されます。

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

使用法

サーバーの実行

インストールされたスクリプトを使用してサーバーを直接実行できます。

uvx testrail-mcp

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

MCPクライアントでの使用

クロードデスクトップ

Claude Desktop で、次の構成で新しいサーバーを追加します。

{ "mcpServers": { "testrail": { "command": "uvx", "args": [ "testrail-mcp" ], "env": { "TESTRAIL_URL": "https://your-instance.testrail.io", "TESTRAIL_USERNAME": "your-email@example.com", "TESTRAIL_API_KEY": "your-api-key" } } } }

カーソル

カーソルで、次の構成の新しいカスタムツールを追加します。

{ "name": "TestRail MCP", "command": "uvx", "args": [ "testrail-mcp" ], "env": { "TESTRAIL_URL": "https://your-instance.testrail.io", "TESTRAIL_USERNAME": "your-email@example.com", "TESTRAIL_API_KEY": "your-api-key" } }

ウィンドサーフィン

Windsurf で、次の構成で新しいツールを追加します。

{ "name": "TestRail MCP", "command": "uvx", "args": [ "testrail-mcp" ], "env": { "TESTRAIL_URL": "https://your-instance.testrail.io", "TESTRAIL_USERNAME": "your-email@example.com", "TESTRAIL_API_KEY": "your-api-key" } }

MCP Inspectorによるテスト

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

npx @modelcontextprotocol/inspector \ -e TESTRAIL_URL=<your-url> \ -e TESTRAIL_USERNAME=<your-username> \ -e TESTRAIL_API_KEY=<your-api-key> \ uvx testrail-mcp

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