MCP컨트롤
마우스, 키보드, 창 관리, 화면 캡처 기능을 포함한 시스템 작업에 대한 프로그래밍 방식 제어를 제공하는 모델 컨텍스트 프로토콜을 위한 Windows 제어 서버입니다.
참고 : 이 프로젝트는 현재 Windows만 지원합니다.
🔥 왜 MCPControl인가요?
MCPControl은 AI 모델과 데스크톱 간의 격차를 해소하여 다음을 안전하고 프로그래밍 방식으로 제어할 수 있도록 해줍니다.
- 🖱️ 마우스 움직임 및 클릭
- ⌨️ 키보드 입력 및 단축키
- 🪟 창 관리
- 📸 화면 캡처 및 분석
- 📋 클립보드 작업
🔌 빠른 시작
필수 조건
- 빌드 도구 설치(VC++ 워크로드 포함)지엑스피1
- Python을 설치하세요 (아직 설치되지 않은 경우)
# Install Python (required for node-gyp)
winget install Python.Python.3.12
- Node.js 설치
# Install latest LTS version
winget install OpenJS.NodeJS
설치
- MCPControl 패키지 설치
npm install -g mcp-control
구성
MCPControl은 최적의 클릭 정확도를 위해 1280x720 해상도의 가상 머신 에서 가장 잘 작동합니다.
SSE 전송을 통해 MCPControl에 연결하도록 Claude 클라이언트를 구성하세요.
옵션 1: 직접 SSE 연결
VM 또는 원격 컴퓨터에서 실행되는 MCPControl 서버에 연결하려면 다음을 수행합니다.
{
"mcpServers": {
"MCPControl": {
"transport": "sse",
"url": "http://192.168.1.100:3232/mcp"
}
}
}
192.168.1.100:3232 서버의 IP 주소와 포트로 바꾸세요.
옵션 2: SSE를 사용한 로컬 출시
SSE 전송을 사용하여 로컬로 MCPControl을 시작하려면:
{
"mcpServers": {
"MCPControl": {
"command": "mcp-control",
"args": ["--sse"]
}
}
}
서버 시작
먼저, VM이나 로컬 머신에서 MCPControl 서버를 시작합니다.
서버에 다음이 표시됩니다.
- 사용 가능한 네트워크 인터페이스 및 해당 IP 주소
- 포트 번호(기본값: 3232)
- 연결 상태 메시지
VM 설정 예제
- 1280x720 해상도로 Windows VM을 시작하세요
- VM에 MCPControl을 설치하세요 :
npm install -g mcp-control
- SSE 전송으로 서버를 실행합니다 .
- VM의 IP 주소 (예:
192.168.1.100 )를 기록해 두세요. - SSE URL로 Claude를 구성하세요 :
{
"mcpServers": {
"MCPControl": {
"transport": "sse",
"url": "http://192.168.1.100:3232/mcp"
}
}
}
- Claude를 재시작하면 MCP 메뉴에 MCPControl이 나타납니다!
🔧 CLI 옵션
MCPControl은 고급 구성을 위한 여러 가지 명령줄 플래그를 지원합니다.
# Run with SSE transport on default port (3232)
mcp-control --sse
# Run with SSE on custom port
mcp-control --sse --port 3000
# Run with HTTPS/TLS (required for production deployments)
mcp-control --sse --https --cert /path/to/cert.pem --key /path/to/key.pem
# Run with HTTPS on custom port
mcp-control --sse --https --port 8443 --cert /path/to/cert.pem --key /path/to/key.pem
명령줄 인수
--sse - 네트워크 액세스를 위한 SSE(Server-Sent Events) 전송을 활성화합니다.--port [number] - 사용자 정의 포트 지정(기본값: 3232)--https - HTTPS/TLS 활성화(MCP 사양에 따라 원격 배포에 필요)--cert [path] - TLS 인증서 파일 경로(--https와 함께 필요)--key [path] - TLS 개인 키 파일 경로(--https와 함께 필요)
보안 참고 사항
MCP 사양에 따르면 프로덕션 환경에서는 모든 HTTP 기반 전송에 HTTPS가 필수 입니다. 원격 액세스를 위해 MCPControl을 배포할 때는 항상 유효한 TLS 인증서와 함께 --https 플래그를 사용하십시오.
🚀 인기 있는 사용 사례
지원 자동화
- 애플리케이션 테스트 : 반복적인 UI 테스트를 Claude에게 위임하여 AI가 애플리케이션을 탐색하고 문제를 보고할 수 있도록 합니다.
- 워크플로 자동화 : Claude가 귀하를 대신하여 애플리케이션을 작동하고 귀하가 창의적인 작업에 집중하는 동안 반복적인 작업을 처리합니다.
- 양식 작성 : Claude가 귀하의 감독 하에 데이터 입력 작업을 처리하도록 하세요.
AI 실험
- AI 게임 : Claude가 시각적 피드백을 통해 간단한 게임을 플레이하는 법을 배우는 모습을 지켜보세요
- 시각적 추론 : Claude의 시각적 인터페이스를 탐색하고 시각적 퍼즐을 푸는 능력을 테스트합니다.
- 인간-AI 협업 : Claude가 화면을 보고 복잡한 작업을 도울 수 있는 새로운 상호 작용 패러다임을 탐색하세요.
개발 및 테스트
- 교차 애플리케이션 통합 : 일반적으로 통신하지 않는 애플리케이션을 연결합니다.
- UI 테스트 프레임워크 : 시각적 검증을 통해 강력한 테스트 시나리오 만들기
- 데모 생성 : 제품 데모 생성을 자동화합니다.
⚠️ 중요 면책 조항
이 소프트웨어는 실험적이며 잠재적으로 위험합니다.
이 소프트웨어를 사용함으로써 귀하는 다음 사항을 인정하고 동의합니다.
- 이 도구를 통해 AI 모델이 컴퓨터를 직접 제어할 수 있도록 하는 것은 본질적으로 위험합니다.
- 이 소프트웨어는 마우스, 키보드 및 기타 시스템 기능을 제어할 수 있으며 이로 인해 예상치 못한 결과가 발생할 수 있습니다.
- 귀하는 이 소프트웨어를 전적으로 귀하의 책임 하에 사용하고 있습니다.
- 이 프로젝트의 제작자와 기여자는 이 소프트웨어를 사용하여 발생할 수 있는 손상, 데이터 손실 또는 기타 결과에 대해 책임을 지지 않습니다.
- 이 도구는 적절한 안전 조치가 시행된 통제된 환경에서만 사용해야 합니다.
사용 시 위험은 본인에게 있습니다
🌟 특징
🔧 자동화 제공업체
MCPControl은 다양한 사용 사례에 대해 여러 자동화 공급자를 지원합니다.
- keysender (기본값) - 높은 안정성을 갖춘 기본 Windows 자동화
- PowerShell - 보다 간단한 작업을 위한 Windows PowerShell 기반 자동화
- autohotkey - 고급 자동화 요구 사항을 위한 AutoHotkey v2 스크립팅
공급자 구성
환경 변수를 사용하여 자동화 공급자를 구성할 수 있습니다.
# Use a specific provider for all operations
export AUTOMATION_PROVIDER=autohotkey
# Configure AutoHotkey executable path (if not in PATH)
export AUTOHOTKEY_PATH="C:\Program Files\AutoHotkey\v2\AutoHotkey.exe"
또는 특정 작업에 대해 모듈식 구성을 사용하세요.
# Mix and match providers for different operations
export AUTOMATION_KEYBOARD_PROVIDER=autohotkey
export AUTOMATION_MOUSE_PROVIDER=keysender
export AUTOMATION_SCREEN_PROVIDER=keysender
export AUTOMATION_CLIPBOARD_PROVIDER=powershell
공급자별 문서를 참조하세요.
🛠️ 개발 설정
소스에서 기여하거나 빌드하는 데 관심이 있는 경우 자세한 지침은 CONTRIBUTING.md를 참조하세요.
개발 요구 사항
개발을 위해 이 프로젝트를 빌드하려면 다음이 필요합니다.
- Windows 운영 체제(키센더 종속성에 필요)
- Node.js 18 이상(빌드 도구가 포함된 공식 Windows 설치 프로그램을 사용하여 설치)
- npm 패키지 관리자
- 네이티브 빌드 도구:
- node-gyp:
npm install -g node-gyp - cmake-js:
npm install -g cmake-js
키센더 종속성은 이러한 빌드 도구를 필요로 하는 Windows 특정 네이티브 모듈에 의존합니다.
📋 프로젝트 구조
/src/handlers - 요청 핸들러 및 도구 관리/tools - 핵심 기능 구현/types - TypeScript 유형 정의index.ts - 주요 애플리케이션 진입점
🔖 저장소 브랜치
main - 최신 기능과 변경 사항을 포함하는 주요 개발 브랜치release - 최신 안정 태그(현재 v0.2.0)를 미러링하는 안정 릴리스 브랜치
버전 설치
npm을 사용하여 특정 버전의 MCPControl을 설치할 수 있습니다.
# Install the latest stable release (from release branch)
npm install mcp-control
# Install a specific version
npm install mcp-control@0.1.22
📚 종속성
🚧 알려진 제한 사항
- 현재 창 최소화/복원 작업은 지원되지 않습니다.
- 설정에 따라 여러 화면 기능이 예상대로 작동하지 않을 수 있습니다.
- get_screenshot 유틸리티는 VS Code Extension Cline에서 작동하지 않습니다. GitHub 문제 #1865를 참조하세요.
- 일부 작업에는 대상 애플리케이션에 따라 상승된 권한이 필요할 수 있습니다.
- Windows만 지원됩니다
- MCPControl은 1280x720 해상도의 단일 화면에서 가장 잘 작동합니다. 클릭 정확도는 이 해상도에 최적화되어 있습니다. 오프셋/스케일링 버그를 수정 중이며, 테스터를 모집하거나 테스트 도구 개발에 도움을 주실 분을 찾고 있습니다.
👥 기여하기
CONTRIBUTING.md를 참조하세요.
⚖️ 라이센스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
📖 참고문헌