Tox Testing MCP Server

Example Use Cases

• 1

  Run full test suites or specific test groups in a Python project via tox to gather pass/fail results.

• 2

  Re-run failing test files or individual test cases during iterative debugging and fix validation.

• 3

  Integrate automated test execution into VSCode or MCP-enabled workflows, with configurable timeouts and project paths.

Description

This MCP server executes tox commands from a specified project directory to run pytest tests in several modes (all, group, file, case, directory). It supports running named test groups, individual test files or cases, and can be integrated into VSCode via MCP settings or used by agents like Cline to orchestrate test workflows. Environment variables (TOX_APP_DIR and TOX_TIMEOUT) control the project location and maximum test runtime, helping prevent hung or long-running test processes. It streamlines iterative debugging by allowing agents to rerun failing tests or test cases individually.