AI-Hands

브라우저 자동화

• CDP(Chrome DevTools Protocol)를 통해 기존 Chrome에 연결
• 접근성 우선 방식: 각 요소에 안정적인 ref 부여, CSS 선택자 없이 클릭/입력 가능
• 멀티 탭 관리, 멀티 컨텍스트 격리(쿠키 분리), 네트워크 관찰 기능

Windows UI 자동화

• 네이티브 UIA(UI Automation) COM 인터페이스 사용
• 창 관리(이동, 크기 조절, 스냅, 상태 변경), 요소 찾기, 상태 읽기
• 컴파일 타임에 도구 이름 검증으로 오류 방지

비전/OCR 자동화

• 스크린샷 캡처, 로컬 OCR(임베디드 Rust OCR 크레이트), 템플릿 매칭
• 이미지 diff, 확대/축소 후 OCR 지원

메타 도구

• hands_click, hands_find 등 6단계 에스컬레이션 래더: a11y ref → 퍼지 텍스트 → CSS → 좌표 → UIA → OCR 순으로 시도
• hands_verify: 5단계 검증 래더, hands_login_recovery: 로그인 및 MFA 처리 파이프라인

winget 설치 (권장)

winget 패키지가 게시된 후 다음 명령으로 설치할 수 있습니다:

winget install AIWander.AI-Hands

설치 후 Claude Desktop에 등록하려면 다음 스크립트를 실행합니다:

.installersscriptsregister-hands.ps1

Scoop 설치

scoop install https://raw.githubusercontent.com/AIWander/AI-Hands/main/installers/scoop/ai-hands.json

수동 다운로드

1. GitHub 릴리스 페이지에서 Windows x64용 hands-v1.0.1-x64.exe 또는 ARM64용 hands-v1.0.1-aarch64.exe 다운로드
2. 파일 이름을 hands.exe로 변경하고 %LOCALAPPDATA%CPCservers에 배치
3. Claude Desktop 설정 파일에 MCP 서버로 등록

AI-Hands는 어떤 프로토콜을 사용하나요?

MCP(Model Context Protocol) 서버로 동작합니다.

설치 방법은 어떻게 되나요?

winget, Scoop, 또는 GitHub 릴리스에서 바이너리를 다운로드하여 설치할 수 있습니다.

라이선스는 무엇인가요?

Apache-2.0 라이선스입니다.