MCP Test Utils

100% AI 코드 · 인간 검수

자동화된 데스크톱 UI 테스트를 위한 MCP 서버입니다. 단일 바이너리로 런타임, 의존성, 설치 과정이 필요 없습니다.

Windows x64 전용. macOS 및 Linux 지원 예정.

AI 에이전트에게 눈과 손을 제공합니다: 스크린샷, 창 관리, 마우스, 키보드, UI 자동화, OCR, 파일 검색.

목적

AI 에이전트는 애플리케이션에서 작업을 수행할 수 있지만 화면을 볼 수는 없습니다. 이 서버는 그 간극을 메워줍니다:

Agent triggers action → takes screenshot → sees the result →
switches window → clicks a button → verifies → writes report

완전 자율적이며 사용자 개입이 필요하지 않습니다.

데모

10가지 작업. 한 번에 성공. YouTube에서 보기 →

MCP Test Utils vs Anthropic Computer Use

Claude Cowork에는 이제 내장된 Computer Use 기능이 포함되어 있습니다. Claude는 스크린샷을 찍고 인터페이스를 시각적으로 클릭합니다. 별도의 설정 없이 작동합니다. MCP Test Utils는 다른 접근 방식을 취합니다: 스크린샷에서 클릭할 위치를 추측하는 대신, Windows API를 통해 실제 UI 구조를 읽어들입니다.

MCP Test Utils는 더 빠르고 정밀하며 작업당 비용이 저렴합니다. Computer Use는 시작하기 쉽고 플랫폼 간 호환성이 좋습니다. 두 도구는 상호 보완적입니다.

플랫폼

도구 (19)

비전

창 관리

입력

구조화된 UI 접근

파일 검색

에이전트 가이드

세션 로깅

설치

1. Releases에서 바이너리를 다운로드합니다.

2. MCP 클라이언트 설정에 추가합니다. 아래 예시는 Claude Desktop용이며, 다른 클라이언트는 해당 문서를 참조하세요.

Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "test-utils": {
      "command": "D:\\path\\to\\mcp-test-utils.exe"
    }
  }
}

3. Claude Desktop을 재시작합니다.

4. 채팅에서 다음을 시도해보세요: "Take a screenshot" — 에이전트가 데스크톱 이미지를 반환합니다.

로깅 및 파일 검색 사용 (선택 사항)

{
  "mcpServers": {
    "test-utils": {
      "command": "D:\\path\\to\\mcp-test-utils.exe",
      "env": {
        "MCP_LOG_DIR": "D:\\path\\to\\logs",
        "MCP_LOG_MAX_MB": "500",
        "MCP_LOG_RETAIN_DAYS": "30",
        "MCP_SEARCH_DIRS": "D:\\Projects\\app1;D:\\Projects\\app2"
      }
    }
  }
}

품질 프리셋

스크린샷은 세부 정보와 토큰 비용의 균형을 맞추기 위해 품질 설정이 가능합니다:

환경 변수

작동 원리

MCP Test Utils는 stdin/stdout을 통해 통신하는 JSON-RPC 2.0 서버입니다. MCP 호환 클라이언트가 바이너리를 실행하고, 도구 호출을 보내며, 구조화된 응답(텍스트, base64 이미지)을 받습니다. Claude Desktop에서 테스트되었습니다.

이 서버는 네이티브 Windows API를 직접 사용합니다 — 스크린샷을 위한 Win32 GDI, 마우스 및 키보드를 위한 SendInput, 요소 검사를 위한 UI Automation COM API, 텍스트 인식을 위한 WinRT Windows.Media.Ocr. 파일 검색은 ripgrep 엔진(grep-regex, grep-searcher, ignore)을 사용하며, 외부 의존성 없는 크로스 플랫폼 도구입니다. PowerShell, 외부 도구, 네트워크 접근을 사용하지 않습니다.

사용 사례

• 자동화된 QA — 에이전트가 앱을 탐색하고, 흐름을 클릭하며, 각 단계에서 스크린샷을 찍고, 테스트 보고서를 작성합니다.

• 데스크톱 자동화 — 양식 작성, 창 간 데이터 복사, 워크플로우 실행.

• 접근성 감사 — 누락된 레이블이나 역할에 대해 UI 자동화 트리 스캔.

• 시각적 회귀 테스트 — 릴리스 간 스크린샷 비교.

• 데이터 추출 — API를 제공하지 않는 애플리케이션에서 텍스트 OCR.

• 코드 검색 — 에이전트 세션을 떠나지 않고 여러 프로젝트에서 패턴 검색.

보안

• MCP 클라이언트의 요청에만 응답합니다.

• 네트워크 포트를 열지 않습니다.

• 디스크에 아무것도 쓰지 않습니다 (옵트인 로깅 제외).

• 외부로 데이터를 전송하지 않습니다.

• 스크린샷은 전체 화면을 캡처합니다 — 민감한 정보가 보이지 않도록 주의하세요.

• 파일 검색은 샌드박스 처리됩니다 — MCP_SEARCH_DIRS에 있는 디렉토리만 접근 가능합니다.

지원

무료이며 제한이 없습니다. 유용하게 사용하셨다면 — jeenyjai.github.io

라이선스

Copyright 2026 JeenyJAI. All rights reserved.

🚀 Claude로 제작됨