🚀 Tox テスト MCP サーバー

Model Context Protocol (MCP) をベースにしたテストサーバーで、Python プロジェクトの tox コマンドを実行して pytest テストを行うことができます。このサーバーは、MCP を通じて Python テストを実行および管理する便利な方法を提供します。

✨ 主な機能

ツール

run_tox_tests - tox テストコマンドを実行し、複数のモードとオプションをサポートします。
- サポートされる実行モード：
  - all: すべてのテストまたは指定されたグループ内のテストを実行します。
  - file: 特定のファイル内のテストを実行します。
  - case: 特定のテストケースを実行します。
  - directory: 指定されたディレクトリ内のすべてのテストを実行します。
- サポートされるテストグループ：
  - clients: クライアント関連のテスト
  - api: API エンドポイントのテスト
  - auth: 認証テスト
  - uploads: アップロード機能のテスト
  - routes: ルートハンドラーのテスト

🚀 クイックスタート

開発

依存関係のインストール：

npm install

サーバーのビルド：

npm run build

開発時の自動再構築：

npm run watch

インストール

VSCode で使用するには、サーバー設定を MCP 設定ファイルに追加してください。設定ファイルのパスは以下の通りです： ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "tox-testing": {
      "command": "node",
      "args": ["/path/to/tox-testing/build/index.js"],
      "env": {
        "TOX_APP_DIR": "/path/to/your/python/project",
        "TOX_TIMEOUT": "600"
      }
    }
  }
}

設定オプション

env.TOX_TIMEOUT: (オプション) テスト実行の最大待機時間（秒）。テストの実行時間がこのタイムアウトを超えると、テストは終了します。デフォルト値は 600 秒（10 分）です。
env.TOX_APP_DIR: (必須) tox.ini ファイルを含むディレクトリ。このディレクトリで tox コマンドが実行されます。パスは、tox.ini ファイルを含む Python プロジェクトのルートディレクトリを指す必要があります。

タイムアウトは以下の点で特に重要です：

テストプロセスのハングを防止する
長時間実行される統合テストを管理する
CI/CD パイプラインが停止しないようにする

💻 使用例

基本的な使用法

サーバーは run_tox_tests ツールを提供しており、さまざまなモードで使用できます。

ツールパラメータ

// すべてのテストを実行
{
  "mode": "all"
}

// 指定されたグループ内のテストを実行
{
  "mode": "all",
  "group": "api"
}

// 特定のファイル内のテストを実行
{
  "mode": "file",
  "testFile": "tests/test_api.py"
}

// 特定のテストケースを実行
{
  "mode": "case",