MCP Testrail

🚀 TestRail MCP サーバー

このモデルコンテキストプロトコル (MCP) サーバーは、Claude AI や Cursor などの MCP 対応クライアントで使用するため、TestRail と直接やり取りするツールを提供します。AI との会話から離れることなく、テストケース、プロジェクト、スイート、実行などを管理できます。

✨ 主な機能

TestRail MCP サーバーが提供するツールは以下の通りです。

📦 インストール

この MCP サーバーに接続する方法は以下の通りです。この方法では npx を使用して、最新バージョンのパッケージを自動的にダウンロードして実行し、ローカルにインストールする必要はありません。

// npxを使用したサンプル設定
{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["@bun913/mcp-testrail@latest"],
      "env": {
        "TESTRAIL_URL": "https://your-instance.testrail.io", // あなたのTestRail URLに置き換えてください
        "TESTRAIL_USERNAME": "your-email@example.com", // あなたのTestRailユーザー名に置き換えてください
        "TESTRAIL_API_KEY": "YOUR_API_KEY" // あなたのTestRail APIキーに置き換えてください
      }
    }
  }
}

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

• spawn node ENOENT エラー：Node.js が正しくインストールされ、PATH に含まれていることを確認してください。
• 接続問題：サーバーが実行中であり、MCP クライアントで URL が正しく構成されていることを確認してください。
• 認証問題：.env ファイル内の TestRail API 資格情報を確認してください。
• SSE 接続エラー：SSE error: TypeError: fetch failed: connect ECONNREFUSED が表示される場合は、サーバーが指定されたポートで実行されていることを確認してください。
• 会話が長い場合：テストケースには limit と offset パラメーターを使用してください。

👥 コントリビューション

コントリビューションを歓迎します！自由に Pull Request を送信してください。

🙏 謝辞

以下のリソースに感謝します。

• TestRail API
• モデルコンテキストプロトコル SDK