local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides tools for executing Python tests within a project using tox and pytest. Supports running tests in various modes (all tests, specific test files, individual test cases, or directory-based tests) and different test groups.
Enables running and managing Python test suites using tox commands. Handles different test execution scenarios with configurable timeouts and provides targeted testing capabilities for Python projects.

독성 테스트 MCP 서버

pytest를 사용하여 프로젝트 내에서 파이썬 테스트를 실행하기 위해 tox 명령을 실행하는 MCP 서버입니다. 이 서버는 모델 컨텍스트 프로토콜(MCP)을 통해 파이썬 테스트를 실행하고 관리하는 편리한 방법을 제공합니다.

특징

도구

run_tox_tests - 다양한 모드와 옵션으로 tox 테스트 실행
- 다양한 실행 모드를 지원합니다:
  - all : 모든 테스트 또는 특정 그룹의 테스트를 실행합니다.
  - file : 특정 파일에서 테스트 실행
  - case : 특정 테스트 케이스를 실행합니다
  - directory : 지정된 디렉토리의 모든 테스트를 실행합니다.
- 지원되는 테스트 그룹:
  - clients : 클라이언트 관련 테스트
  - api : API 엔드포인트 테스트
  - auth : 인증 테스트
  - uploads : 업로드 기능 테스트
  - routes : 경로 핸들러 테스트

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

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 제공합니다.

도구 인수

// Run all tests
{
  "mode": "all"
}

// Run tests from a specific group
{
  "mode": "all",
  "group": "api"
}

// Run tests from a specific file
{
  "mode": "file",
  "testFile": "tests/test_api.py"
}

// Run a specific test case
{
  "mode": "case",
  "testFile": "tests/test_api.py",
  "testCase": "test_endpoint_response"
}

// Run tests from a specific directory
{
  "mode": "directory",
  "directory": "tests/api/"
}

Cline과 함께 사용

이 MCP를 Cline과 함께 사용하면 Cline의 사용자 지정 지침을 구성하여 테스트 실행을 효율적으로 처리할 수 있습니다. 권장되는 워크플로는 다음과 같습니다.

If asked to run tests on the project, use the tox-testing MCP. Follow these steps:
Run all tests across the project unless you are given instructions to run a specific test file or test case. 
Review and rerun each failed test case individually as you troubleshoot and fix the issue from its output.
Repeat step 2 until the testcase passes.
Once all failed test cases from step 1 are passing rerun all tests again and repeat all steps until all tests pass.

이 워크플로는 다음을 보장합니다.

모든 테스트를 먼저 실행하여 포괄적인 테스트 범위 제공
실패한 테스트 케이스를 분리하여 집중 디버깅
개별 사례를 다시 테스트하여 수정 사항 확인
모든 테스트를 다시 실행하여 최종 검증

클라인과의 상호작용 예시:

You: Run the tests for this project
Cline: I'll use the tox-testing MCP to run all tests:
{
  "mode": "all"
}

You: Fix the failing test in test_api.py
Cline: I'll first run the specific test file:
{
  "mode": "file",
  "testFile": "tests/test_api.py"
}
Then address each failing test case individually:
{
  "mode": "case",
  "testFile": "tests/test_api.py",
  "testCase": "test_endpoint_response"
}

기여하다

행동 강령과 풀 리퀘스트 제출 프로세스에 대한 자세한 내용은 CONTRIBUTING.md를 참조하세요.

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

run_tox_tests

pytest를 사용하여 프로젝트 내에서 Python 테스트를 실행하기 위해 tox 명령을 실행하는 MCP 서버로, 사용자는 모든 테스트 또는 특정 테스트 그룹, 파일, 케이스 또는 디렉토리를 실행할 수 있습니다.

Related Resources

Reddit Discussion about this server

Tox Testing MCP Server