테스트 러너 MCP

여러 테스트 프레임워크의 테스트 결과를 실행하고 파싱하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 테스트를 실행하고 결과를 처리하는 통합 인터페이스를 제공하며, 다음을 지원합니다.

배츠(Bash 자동 테스트 시스템)
Pytest(Python 테스트 프레임워크)
플러터 테스트
Jest(JavaScript 테스트 프레임워크)
고 테스트
녹 테스트(화물 테스트)
일반(임의의 명령 실행용)

설치

지엑스피1

필수 조건

각 테스트 유형에 대해 다음 테스트 프레임워크를 설치해야 합니다.

박쥐: apt-get install bats 또는 brew install bats
Pytest: pip install pytest
플러터: 플러터 설치 가이드를 따르세요
농담: npm install --save-dev jest
Go: Go 설치 가이드를 따르세요
Rust: Rust 설치 가이드를 따르세요

용법

구성

MCP 설정에 테스트 러너를 추가합니다(예: claude_desktop_config.json 또는 cline_mcp_settings.json ):

{
  "mcpServers": {
    "test-runner": {
      "command": "node",
      "args": ["/path/to/test-runner-mcp/build/index.js"],
      "env": {
        "NODE_PATH": "/path/to/test-runner-mcp/node_modules",
        // Flutter-specific environment (required for Flutter tests)
        "FLUTTER_ROOT": "/opt/homebrew/Caskroom/flutter/3.27.2/flutter",
        "PUB_CACHE": "/Users/username/.pub-cache",
        "PATH": "/opt/homebrew/Caskroom/flutter/3.27.2/flutter/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

참고: Flutter 테스트의 경우 다음을 교체해야 합니다.

/opt/homebrew/Caskroom/flutter/3.27.2/flutter 실제 Flutter 설치 경로로 지정합니다.
/Users/username/.pub-cache 에 실제 pub 캐시 경로를 추가합니다.
시스템의 실제 경로를 포함하도록 PATH를 업데이트하세요.

다음을 실행하여 이러한 값을 찾을 수 있습니다.

# Get Flutter root
flutter --version

# Get pub cache path
echo $PUB_CACHE   # or default to $HOME/.pub-cache

# Get Flutter binary path
which flutter

테스트 실행

다음 매개변수와 함께 run_tests 도구를 사용하세요.

{
  "command": "test command to execute",
  "workingDir": "working directory for test execution",
  "framework": "bats|pytest|flutter|jest|go|rust|generic",
  "outputDir": "directory for test results",
  "timeout": "test execution timeout in milliseconds (default: 300000)",
  "env": "optional environment variables",
  "securityOptions": "optional security options for command execution"
}

각 프레임워크의 예:

// Bats
{
  "command": "bats test/*.bats",
  "workingDir": "/path/to/project",
  "framework": "bats",
  "outputDir": "test_reports"
}

// Pytest
{
  "command": "pytest test_file.py -v",
  "workingDir": "/path/to/project",
  "framework": "pytest",
  "outputDir": "test_reports"
}

// Flutter
{
  "command": "flutter test test/widget_test.dart",
  "workingDir": "/path/to/project",
  "framework": "flutter",
  "outputDir": "test_reports",
  "FLUTTER_ROOT": "/opt/homebrew/Caskroom/flutter/3.27.2/flutter",
  "PUB_CACHE": "/Users/username/.pub-cache",
  "PATH": "/opt/homebrew/Caskroom/flutter/3.27.2/flutter/bin:/usr/local/bin:/usr/bin:/bin"
}

// Jest
{
  "command": "jest test/*.test.js",
  "workingDir": "/path/to/project",
  "framework": "jest",
  "outputDir": "test_reports"
}

// Go
{
  "command": "go test ./...",
  "workingDir": "/path/to/project",
  "framework": "go",
  "outputDir": "test_reports"
}

// Rust
{
  "command": "cargo test",
  "workingDir": "/path/to/project",
  "framework": "rust",
  "outputDir": "test_reports"
}

// Generic (for arbitrary commands, CI/CD tools, etc.)
{
  "command": "act -j build",
  "workingDir": "/path/to/project",
  "framework": "generic",
  "outputDir": "test_reports"
}

// Generic with security overrides
{
  "command": "sudo docker-compose -f docker-compose.test.yml up",
  "workingDir": "/path/to/project",
  "framework": "generic",
  "outputDir": "test_reports",
  "securityOptions": {
    "allowSudo": true
  }
}

보안 기능

테스트 러너에는 특히 generic 프레임워크에 대해 잠재적으로 유해한 명령의 실행을 방지하기 위한 내장 보안 기능이 포함되어 있습니다.

명령 검증
- 기본적으로 sudo 및 su 차단합니다.
- rm -rf / 와 같은 위험한 명령을 방지합니다.
- 안전한 위치 외부에서 파일 시스템 쓰기 작업을 차단합니다.
환경 변수 정리
- 잠재적으로 위험한 환경 변수를 필터링합니다.
- 중요한 시스템 변수의 재정의를 방지합니다.
- 안전한 경로 처리를 보장합니다
구성 가능한 보안
- 필요한 경우 securityOptions 통해 보안 제한을 재정의합니다.
- 보안 기능에 대한 세분화된 제어
- 표준 테스트 사용을 위한 기본 안전 설정

구성할 수 있는 보안 옵션:

{
  "securityOptions": {
    "allowSudo": false,        // Allow sudo commands
    "allowSu": false,          // Allow su commands
    "allowShellExpansion": true, // Allow shell expansion like $() or backticks
    "allowPipeToFile": false   // Allow pipe to file operations (> or >>)
  }
}

플러터 테스트 지원

테스트 러너에는 Flutter 테스트에 대한 향상된 지원이 포함되어 있습니다.

환경 설정
- 자동 Flutter 환경 구성
- PATH 및 PUB_CACHE 설정
- 플러터 설치 검증
오류 처리
- 스택 추적 수집
- 어설션 오류 처리
- 예외 캡처
- 테스트 실패 감지
출력 처리
- 테스트 출력 캡처 완료
- 스택 추적 보존
- 자세한 오류 보고
- 원시 출력 보존

녹 테스트 지원

테스트 러너는 Rust의 cargo test 에 대한 특정 지원을 제공합니다.

환경 설정
- 더 나은 오류 메시지를 위해 RUST_BACKTRACE=1을 자동으로 설정합니다.
출력 구문 분석
- 개별 테스트 결과를 구문 분석합니다.
- 실패한 테스트에 대한 자세한 오류 메시지를 캡처합니다.
- 무시된 테스트를 식별합니다.
- 요약 정보를 추출합니다

일반 테스트 지원

CI/CD 파이프라인, act 통한 GitHub Actions 또는 기타 명령 실행의 경우 일반 프레임워크는 다음을 제공합니다.

자동 출력 분석
- 출력을 논리 블록으로 분할하려는 시도
- 섹션 헤더를 식별합니다
- 합격/불합격 지표 감지
- 알려지지 않은 형식에 대해서도 합리적인 출력 구조를 제공합니다.
유연한 통합
- 임의의 셸 명령으로 작동합니다
- 특정 형식 요구 사항 없음
- act , Docker 및 사용자 정의 스크립트와 같은 도구와의 통합에 적합합니다.
보안 기능
- 유��한 작업을 방지하기 위한 명령 검증
- 필요한 경우 특정 승격된 권한을 허용하도록 구성할 수 있습니다.

출력 형식

테스트 러너는 완전한 테스트 출력을 보존하면서 구조화된 출력을 생성합니다.

interface TestResult {
  name: string;
  passed: boolean;
  output: string[];
  rawOutput?: string;  // Complete unprocessed output
}

interface TestSummary {
  total: number;
  passed: number;
  failed: number;
  duration?: number;
}

interface ParsedResults {
  framework: string;
  tests: TestResult[];
  summary: TestSummary;
  rawOutput: string;  // Complete command output
}

결과는 지정된 출력 디렉토리에 저장됩니다.

test_output.log : 원시 테스트 출력
test_errors.log : 오류 메시지가 있는 경우
test_results.json : 구조화된 테스트 결과
summary.txt : 사람이 읽을 수 있는 요약

개발

설정

저장소를 복제합니다
종속성 설치:
npm install
프로젝트를 빌드하세요:
npm run build

테스트 실행

npm test

테스트 모음에는 지원되는 모든 프레임워크에 대한 테스트가 포함되어 있으며 성공한 테스트 시나리오와 실패한 테스트 시나리오를 모두 검증합니다.

CI/CD

이 프로젝트에서는 지속적인 통합을 위해 GitHub Actions를 사용합니다.

Node.js 18.x 및 20.x에서 자동화된 테스트
아티팩트로 업로드된 테스트 결과
자동 종속성 업데이트를 위해 구성된 Dependabot

기여하다

저장소를 포크하세요
기능 브랜치를 생성하세요
변경 사항을 커밋하세요
지점으로 밀어 넣기
풀 리퀘스트 만들기

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

run_tests

Bats, Pytest, Flutter, Jest, Go 등 다양한 테스트 프레임워크에 대한 통합 실행 및 결과 구문 분석을 모델 컨텍스트 프로토콜 인터페이스를 통해 용이하게 합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Qase MCP Server
RayYokoyama
-
security
F
license
-
quality
A Model Context Protocol server that integrates with the Qase test management platform, allowing users to create and retrieve test cases, manage test runs, and interact with Qase projects.
Last updated -
1
JavaScript
k6-mcp-server
QAInsights
-
security
A
license
-
quality
A Model Context Protocol (MCP) server implementation that allows AI assistants to run k6 load tests through natural language commands, supporting custom test durations and virtual users.
Last updated -
1
Python
MIT License
JMeter MCP Server
QAInsights
A
security
F
license
A
quality
A Model Context Protocol server that allows AI assistants to execute and manage JMeter performance tests through natural language commands.
Last updated -
2
27
Python
Pentest MCP
DMontgomery40
A
security
A
license
A
quality
A Model Context Protocol server that integrates essential penetration testing tools (Nmap, Gobuster, Nikto, John the Ripper) into a unified natural language interface, allowing security professionals to execute and chain multiple tools through conversational commands.
Last updated -
8
36
42
JavaScript
MIT License

View all related MCP servers

Test Runner MCP