Testmo MCPサーバー

Testmo 用のPython Model Context Protocol (MCP) サーバー - Claude Desktop、Cursor、およびMCP互換クライアントでAI支援によるテスト管理を実現します。

Testmo MCPは、Claude Desktop、Claude Code、CursorなどのAIアシスタントを、Testmoテスト管理インスタンスに直接接続するオープンソースのMCPサーバーです。AIクライアントを離れることなく、自然言語を使用してテストケース、フォルダー、マイルストーン、実行、添付ファイル、CI/CD自動化ソースを管理できます。

Testmoを使用しており、反復的な作業のためにUIをクリックし続けることから解放されたいQAエンジニア、SDET、開発者向けに構築されています。FastMCPとTestmo REST APIを活用しています。

✨ 機能

• 🧪 完全なテストケース管理 — Testmoケースの作成、読み取り、更新、削除、検索、一括操作

• 📁 フォルダー操作 — フォルダーツリーの作成、名前変更、移動、削除、再帰的なトラバース

• 🚀 一括およびバッチ操作 — 呼び出しごとに最大100件のケースを作成または更新、自動バッチ処理により無制限に実行可能

• 🏃 テスト実行と結果 — 実行のリスト表示、実行詳細の取得、実行結果のフィルタリング

• 🎯 マイルストーン — プロジェクト全体のマイルストーンのリスト表示と調査

• 📎 添付ファイル — テストケースへのファイル添付ファイルのアップロード、リスト表示、削除

• 🤖 CI/CD自動化ソース — 自動化実行、並列スレッド、結果送信の管理

• 🔗 課題統合 — GitHub、Jira、その他の課題接続のリスト表示

• 🌳 再帰的ヘルパー — 1回の呼び出しでフォルダーのサブツリー全体のケースを取得

• 🛠️ フィールドマッピングユーティリティ — 推測なしで優先度、タイプ、状態IDを解決

• 🤝 あらゆるMCPクライアントで動作 — Claude Desktop、Claude Code、Cursor、Clineなど

🚀 クイックスタート

前提条件

• Python 3.11以降

• uv パッケージマネージャー

• TestmoインスタンスとAPIキー (Testmoの設定 → APIキー)

• MCP互換クライアント (Claude Desktop、Cursorなど)

インストール

git clone https://github.com/strelec00/testmo-mcp.git
cd testmo-mcp
uv sync

設定

プロジェクトルートに .env ファイルを作成します：

TESTMO_URL=https://your-instance.testmo.net
TESTMO_API_KEY=your-api-key

Claude Desktopへの接続

Claude Desktopの設定ファイルに以下を追加します：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "testmo": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/testmo-mcp", "run", "testmo-mcp.py"],
      "env": {
        "TESTMO_URL": "https://your-instance.testmo.net",
        "TESTMO_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktopを再起動します。MCPツールリストにTestmoツールが表示されます。

💡 資格情報は .env または上記の env ブロックのどちらからでも渡すことができます。どちらも機能します。

Cursorへの接続

Cursor設定 → MCPを開くか（または ~/.cursor/mcp.json を編集）、同じJSONスニペットを使用します。

開発 / テストモード

uv run mcp dev testmo-mcp.py

💬 プロンプト例

接続したら、AIアシスタントに次のように尋ねてみてください：

• "Testmoのすべてのプロジェクトをリストアップし、Certilligentという名前のプロジェクトを表示して。"

• "有効な資格情報、間違ったパスワード、ロックされたアカウント、期限切れのセッション、2FAフローをカバーする20個のログインテストケースを作成して。"

• "'Smoke Tests'フォルダーを見つけて、その中の優先度の高いケースをすべて再帰的にリストアップして。"

• "フォルダー42にあるすべてのドラフトケースを一括更新して、優先度を高に設定して。"

• "Playwrightソースの最新の自動化実行を表示し、新しい結果スレッドを追加して。"

• "このスクリーンショットをテストケース1234の添付ファイルとしてアップロードして。"

🧠 なぜTestmoでMCPを使うのか？

従来のTestmoワークフローでは、すべてのテストケース、すべてのフォルダー、すべての一括更新に対してUIを操作する必要がありました。Testmo MCPを使用すると、AIアシスタントがQAの副操縦士になります：

• 機能仕様書やPRDから数秒でテストスイート全体を立ち上げる

• クリック操作ではなく、会話形式でフォルダー構造をリファクタリングする

• コンテキストを切り替えることなく、Testmoをコードベースと同期させる

• Claude Codeと組み合わせてエンドツーエンドのQA自動化を実現：Playwrightテストを生成し、Testmoに登録する

• ターミナルセッションから直接CI/CD自動化実行を配線する

🔧 利用可能なツール

プロジェクト

フォルダー

テストケース

マイルストーン

テスト実行

添付ファイル

自動化 (CI/CD)

課題接続

再帰的 / 複合

ユーティリティ

🛠️ トラブルシューティング

Claude Desktopで「Tool not found」と表示される場合 argsに絶対パスを使用し、設定を編集した後にClaude Desktopを完全に再起動してください。

401 Unauthorized TESTMO_API_KEYを再確認し、Testmoの設定 → APIキーでAPIアクセスが有効になっていることを確認してください。

uv: command not found uvをインストールしてください: curl -LsSf https://astral.sh/uv/install.sh | sh

🤝 コントリビューション

プルリクエストを歓迎します。大きな変更を行う前に、まずIssueを作成してください。

📄 ライセンス

MIT

🔗 関連プロジェクト

• Testmo — ソフトウェアチーム向けの統合テスト管理

• Model Context Protocol — AIツール統合のためのオープン標準

• FastMCP — MCPサーバー構築のためのPythonフレームワーク

• Claude Desktop — MCPをサポートするAnthropicのデスクトップクライアント

キーワード: testmo mcp, testmo claude, testmo ai integration, mcp server testmo, model context protocol testmo, testmo python, testmo api client, fastmcp testmo, ai test management, qa automation claude, testmo cursor, testmo automation api, testmo bulk create cases, anthropic mcp servers