remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Enables remote control of macOS systems through screen sharing, allowing AI agents to capture screenshots, send keyboard inputs, control mouse movements, and interact with any macOS application without requiring additional software installation.
Provides a direct alternative to OpenAI Operator, allowing OpenAI models to interact with and control macOS systems through the MCP protocol.
Supports interaction with YouTube, as demonstrated in showcases where the system is used to create short highlight videos using applications like CapCut.
MCP 서버 - 원격 MacOS 사용
AI가 원격 macOS 시스템을 완벽하게 제어할 수 있도록 하는 최초의 오픈 소스 MCP 서버입니다.
OpenAI Operator에 대한 직접적인 대안으로, 완전한 데스크톱 기능을 갖춘 자율 AI 에이전트에 특별히 최적화되었으며, 추가 소프트웨어 설치가 필요 없습니다.
쇼케이스
- 트위터를 조사하고 트위터에 게시하세요( https://www.youtube.com/watch?v=--QHz2jcvcs )
- CapCut을 사용하여 짧은 하이라이트 영상을 만들어 보세요( https://www.youtube.com/watch?v=RKAqiNoU8ec )
- AI 채용 담당자: 메일 앱을 사용하여 후보자 정보 수집을 자동화하고, 지원서 심사 및 스크리닝 세션을 전송합니다.
- AI 마케팅 인턴: LinkedIn 참여 - 관련 사용자를 자동으로 팔로우하고, 좋아요를 누르고, 댓글을 달 수 있습니다.
- AI 마케팅 인턴: 트위터 참여 - 관련 사용자에 대한 자동 팔로잉, 좋아요 및 댓글 달기
할 일 목록(우선순위 지정)
- 성능 최적화 - Ubuntu 데스크톱 대안의 속도 맞추기
- Apple Scripts 생성 - 유연성을 유지하면서 실행 시간 단축
- VNC 커서 가시성 - 디버깅 및 데모 경험 개선
기여를 환영합니다!
특징
- 추가 API 비용 없음 : 기존 Claude Pro 플랜으로 무료 화면 처리
- 최소 설정 : 대상 Mac에서 화면 공유를 활성화하기만 하면 됩니다. 추가 소프트웨어가 필요하지 않습니다.
- 범용 호환성 : 현재 및 미래의 모든 macOS 버전과 호환됩니다.
우리가 이것을 만든 이유
타협 없는 네이티브 macOS 경험
macOS 네이티브 생태계는 오늘날 사용자 경험 측면에서 독보적인 위치를 차지하고 있으며, 앞으로도 오랫동안 최고의 기준으로 자리매김할 것입니다. 바로 이 부분에서 인간의 능력이 진정으로 발휘되며, 이제 AI도 이 환경에서 동일한 수준의 유창함을 유지할 수 있습니다.
디자인에 따른 개방형 아키텍처
- 범용 LLM 호환성 : 선택한 모든 MCP 클라이언트와 함께 작업 가능
- 모델 유연성 : OpenAI, Anthropic 또는 기타 LLM 공급자와 원활하게 통합
- 미래 지향적 통합 : MCP 생태계와 함께 발전하도록 설계됨
간편한 배포
- 대상 컴퓨터에서 제로 설정 : macOS에서 백그라운드 애플리케이션이나 에이전트가 필요하지 않습니다.
- 화면 공유만 있으면 됩니다 . 화면 공유를 활성화하여 모든 Mac을 제어하세요.
- 백엔드 복잡성 제거 : Python 애플리케이션이나 백그라운드 서비스 실행이 필요한 다른 솔루션과 달리
간소화된 부트스트랩 프로세스
- Claude Desktop의 세련된 UI 활용 : 개발자 스타일의 Python 인터페이스가 필요 없습니다.
- 직관적인 사용자 경험 : 친숙하고 사용자 친화적인 인터페이스를 통해 AI가 제어하는 Mac과 상호 작용하세요.
- 즉각적인 생산성 : 구성의 번거로움 없이 즉시 작업을 시작하세요
건축학
설치
- MacOs에서 화면 공유 활성화 macstadium.com에서 Mac을 대여한 경우 이 단계를 건너뛸 수 있습니다.
- 원격 MacOs에 연결
- 로컬 Mac에 Docker Desktop 설치
- Claude Desktop에 이 MCP 서버를 추가합니다. Claude 구성에 다음을 추가하여 Docker 이미지를 사용하도록 Claude Desktop을 구성할 수 있습니다.
지엑스피1
LiveKit을 통한 WebRTC 지원
이 서버에는 이제 LiveKit 통합을 통한 WebRTC 지원이 포함되어 다음을 사용할 수 있습니다.
- 저지연 실시간 화면 공유
- 향상된 성능 및 반응성
- 기존 VNC에 비해 네트워크 효율성이 더 우수합니다.
- 네트워크 상황에 따른 자동 품질 조정
WebRTC 기능을 사용하려면 다음이 필요합니다.
- LiveKit 서버를 설정하거나 LiveKit Cloud를 사용하세요
- 위의 구성 예제에 표시된 대로 LiveKit 환경 변수를 구성합니다.
개발자 지침
저장소를 복제합니다
Docker 이미지 빌드
크로스 플랫폼 퍼블리싱
여러 플랫폼에 Docker 이미지를 게시하려면 docker buildx 명령을 사용할 수 있습니다. 다음 단계를 따르세요.
- 새로운 빌더 인스턴스를 만듭니다 (아직 만들지 않았다면):Copy
- 여러 플랫폼에 대한 이미지를 빌드하고 푸시합니다 .Copy
- 지정된 플랫폼에서 이미지를 사용할 수 있는지 확인하세요 .Copy
용법
이 서버는 MCP 도구를 통해 원격 MacOs 기능을 제공합니다.
도구 사양
이 서버는 원격 macOS 제어를 위해 다음과 같은 도구를 제공합니다.
원격_macos_get_screen
원격 macOS 컴퓨터에 연결하여 원격 데스크톱의 스크린샷을 얻습니다.
원격_macos_키_전송
원격 macOS 컴퓨터로 키보드 입력을 보냅니다.
원격_macos_마우스_움직임
자동 좌표 크기 조정을 사용하여 원격 macOS 컴퓨터에서 마우스 커서를 지정된 좌표로 이동합니다.
원격_macos_마우스_클릭
자동 좌표 크기 조정을 사용하여 원격 macOS 컴퓨터에서 지정된 좌표에서 마우스 클릭을 수행합니다.
리모트_맥_마우스_더블_클릭
자동 좌표 크기 조정을 사용하여 원격 macOS 컴퓨터에서 지정된 좌표에서 마우스를 두 번 클릭합니다.
원격_macos_마우스_스크롤
자동 좌표 크기 조정을 사용하여 원격 macOS 컴퓨터에서 지정된 좌표로 마우스 스크롤을 수행합니다.
원격_macos_오픈_애플리케이션
애플리케이션을 열고 활성화하고, 추가적인 상호작용을 위해 PID를 반환합니다.
원격_macos_마우스_드래그_앤_드롭
자동 좌표 크기 조정을 사용하여 원격 macOS 컴퓨터에서 시작 지점에서 마우스 드래그 작업을 수행하고 끝 지점으로 놓습니다.
모든 도구는 연결 매개변수를 요구하는 대신 설치 중에 구성된 환경 변수를 사용합니다.
제한 사항
- 인증 지원 :
- Apple 인증(프로토콜 30)만 지원됩니다.
보안 참고 사항
https://support.apple.com/guide/remote-desktop/encrypt-network-data-apdfe8e386b/mac https://cafbit.com/post/apple\_remote\_desktop\_quirks/
512비트 소수를 사용하는 Diffie-Hellman 키 합의 프로토콜을 사용하는 프로토콜 30만 지원합니다. 이 프로토콜은 macOS 11부터 macOS 12까지 OS X 10.11 이하 클라이언트와 통신할 때 사용됩니다.
마크다운 표로 변환된 정보는 다음과 같습니다.
| 원격 데스크톱을 실행하는 macOS 버전 | macOS 클라이언트 버전 | 입증 | 제어하고 관찰하다 | 항목 복사 또는 패키지 설치 | 다른 모든 작업 | 프로토콜 버전 |
|---|---|---|---|---|---|---|
| 맥OS 13 | 맥OS 13 | 2048비트 RSA 호스트 키 | 2048비트 RSA 호스트 키 | 인증을 위한 2048비트 RSA 호스트 키, 그 다음 128비트 AES | 2048비트 RSA 호스트 키 | 36 |
| 맥OS 13 | 맥OS 10.12 | 로컬 전용 보안 원격 암호(SRP) 프로토콜입니다. LDAP 또는 macOS 서버에 바인딩된 경우 Diffie-Hellman(DH)이 10.11 이하 버전입니다. | SRP 또는 DH, 128비트 AES | 인증을 위해 SRP 또는 DH를 사용한 후 128비트 AES를 사용합니다. | 2048비트 RSA 호스트 키 | 35 |
| macOS 11에서 macOS 12로 | macOS 10.12에서 macOS 13으로 | 로컬 전용 SRP(Secure Remote Password) 프로토콜, LDAP에 바인딩된 경우 Diffie-Hellman | SRP 또는 DH 1024비트, 128비트 AES | 2048비트 RSA 호스트 키 macOS 13 ~ macOS 10.13 | 2048비트 RSA 호스트 키 macOS 10.13 이상 | 33 |
| macOS 11에서 macOS 12로 | OS X 10.11 또는 이전 버전 | DH 1024비트 | DH 1024비트, 128비트 AES | 512비트 소수를 사용한 Diffie-Hellman 키 합의 프로토콜 | 512비트 소수를 사용한 Diffie-Hellman 키 합의 프로토콜 | 30 |
원격 MacOS 시스템에 접속할 때는 항상 안전하고 인증된 연결을 사용하세요. 이 도구는 신뢰할 수 있고 접속 권한이 있는 서버에서만 사용해야 합니다.
MacOs 에이전트 클라이언트
LiveKit 룸에 연결하여 원격 macOS 제어를 지원하는 경량 에이전트입니다. 폴링 오버헤드 없이 지속적인 환경 인식을 유지하여 응답성과 성능을 크게 향상시키는 당사만의 "keep_eyes_open" 시스템을 탑재했습니다. 이를 통해 효율적인 양방향 데이터 채널을 통해 거의 실시간에 가까운 명령 실행 및 피드백이 가능합니다.
특허
You must be authenticated.
Tools
AI가 원격 macOS 시스템을 완벽하게 제어할 수 있도록 하는 최초의 오픈 소스 MCP 서버입니다.