MCP컨트롤

마우스, 키보드, 창 관리, 화면 캡처 기능을 포함한 시스템 작업에 대한 프로그래밍 방식 제어를 제공하는 모델 컨텍스트 프로토콜을 위한 Windows 제어 서버입니다.

몇 달 전, 클로드가 비디오 게임을 할 수 있는지 알아보고 싶어서 실험 삼아 이 프로젝트를 개발했습니다. 작동하는 모습을 보고 감명받았지만, 잠시 미뤄두었습니다. 최근 커뮤니티의 관심을 받아 개발을 재개하게 되었습니다. 현재는 사전 출시 단계이지만, 안정적인 버전을 위해 적극적으로 작업하고 있습니다. 문제가 발생하면 이슈 트래커를 통해 제출해 주세요.

참고 : 이 프로젝트는 현재 Windows만 지원합니다.

⚠️ 중요 면책 조항

이 소프트웨어는 실험적이며 잠재적으로 위험합니다.

이 소프트웨어를 사용함으로써 귀하는 다음 사항을 인정하고 동의합니다.

• 이 도구를 통해 AI 모델이 컴퓨터를 직접 제어할 수 있도록 하는 것은 본질적으로 위험합니다.
• 이 소프트웨어는 마우스, 키보드 및 기타 시스템 기능을 제어할 수 있으며 이로 인해 예상치 못한 결과가 발생할 수 있습니다.
• 귀하는 이 소프트웨어를 전적으로 귀하의 책임 하에 사용하고 있습니다.
• 이 프로젝트의 제작자와 기여자는 이 소프트웨어를 사용하여 발생할 수 있는 손상, 데이터 손실 또는 기타 결과에 대해 책임을 지지 않습니다.
• 이 도구는 적절한 안전 조치가 시행된 통제된 환경에서만 사용해야 합니다.

사용 시 위험은 본인에게 있습니다

특징

• 창 관리
  • 모든 창 나열
  • 활성 창 정보 가져오기
  • 창 제목 가져오기
  • 창 크기와 위치 가져오기
  • 창에 초점 맞추기
  • 창 크기 조정
  • 창 위치 변경
• 마우스 제어
  • 마우스 움직임
  • 클릭 작업
  • 스크롤 기능
  • 드래그 작업
  • 커서 위치 추적
• 키보드 제어
  • 텍스트 입력
  • 키 조합
  • 주요 보도자료/출판 작업
  • 키 기능 유지
• 화면 작업
  • 화면 캡처
  • 화면 크기 검색
  • 활성 창 감지
• 클립보드 통합
  • 클립보드 내용 가져오기
  • 클립보드 내용 설정
  • 클립보드 지우기
  • 클립보드 상태 확인

용법

MCP 서버 구성 섹션에 표시된 대로 Claude MCP 설정을 구성하여 MCPControl을 사용하기만 하면 됩니다. 설치는 필요 없습니다!

소스로부터 구축

소스에서 기여하거나 빌드하는 데 관심이 있는 경우 자세한 지침은 CONTRIBUTING.md를 참조하세요.

개발 요구 사항

개발을 위해 이 프로젝트를 빌드하려면 다음이 필요합니다.

1. Windows 운영 체제(키센더 종속성에 필요)
2. Node.js 18 이상(빌드 도구가 포함된 공식 Windows 설치 프로그램을 사용하여 설치)
3. npm 패키지 관리자
4. 네이티브 빌드 도구:
   • node-gyp: npm install -g node-gyp
   • cmake-js: npm install -g cmake-js

키센더 종속성은 이러한 빌드 도구를 필요로 하는 Windows 특정 네이티브 모듈에 의존합니다.

MCP 서버 구성

이 프로젝트를 사용하려면 필요한 빌드 도구가 필요합니다.

1. 필수 빌드 도구가 포함된 공식 Windows 설치 프로그램을 사용하여 Node.js를 설치합니다.
2. 추가로 필요한 도구를 설치하세요:

지엑스피1

그런 다음 MCP 설정에 다음 구성을 추가합니다.

MCP 설정을 구성한 후 클라이언트를 다시 시작하면 메뉴에서 MCPControl 서비스를 확인할 수 있습니다.

프로젝트 구조

• /src
  • /handlers - 요청 핸들러 및 도구 관리
  • /tools - 핵심 기능 구현
  • /types - TypeScript 유형 정의
  • index.ts - 주요 애플리케이션 진입점

종속성

• @modelcontextprotocol/sdk - 프로토콜 구현을 위한 MCP SDK
• keysender - Windows 전용 UI 자동화 라이브러리
• clipboardy - 클립보드 처리
• 샤프 - 이미지 처리
• uuid - UUID 생성

테스트

이 프로젝트에는 현재 핵심 기능에 대한 단위 테스트가 포함되어 있습니다. 향후 개발될 테스트 영역은 다음과 같습니다.

• 모듈 간 기능에 대한 통합 테스트
• 성능 테스트
• 오류 처리 검증

알려진 제한 사항

• 현재 창 최소화/복원 작업은 지원되지 않습니다.
• 설정에 따라 여러 화면 기능이 예상대로 작동하지 않을 수 있습니다.
• get_screenshot 유틸리티는 VS Code Extension Cline에서 작동하지 않습니다. GitHub 문제 #1865를 참조하세요.
• 일부 작업에는 대상 애플리케이션에 따라 상승된 권한이 필요할 수 있습니다.
• Windows만 지원됩니다

기여하다

CONTRIBUTING.md를 참조하세요.

특허

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

참고문헌

• 모델 컨텍스트 프로토콜 문서