nuphus-mcp
화면과 창, 마우스, 크롬을 MCP 로 여는 데스크톱 자동화 서버
npm install -g @nuphus/nuphus-mcp데스크톱과 브라우저 자동화를 표준 MCP 도구로 노출합니다. 표준 입출력으로 통신하므로 상주 프로세스도 네트워크 서비스도 없고 실행 파일 하나면 됩니다. 어떤 MCP 클라이언트든 붙는 즉시 화면과 창, 키보드와 마우스, 크롬을 제어합니다. 도구는 38개로 데스크톱 15개와 브라우저 23개로 나뉩니다. 화면 크기와 캡처, 창 목록과 활성화, 이동과 크기 조절, 마우스 클릭과 끌기, 키보드 입력과 단축키, 클립보드까지 덮습니다. 데스크톱과 브라우저 자동화에는 API 키가 필요 없고 문자 인식은 지역에서 돕니다. 화면을 보고 판단하는 기능만 자기 시각 모델을 연결해서 씁니다.
판단
이럴 때 씁니다
- 에이전트에 화면 조작 능력을 줘야 할 때
- 데스크톱 앱과 브라우저를 함께 다뤄야 할 때
- API 키 없이 자동화를 시작하고 싶을 때
이럴 땐 쓰지 마세요
- 화면을 보고 판단하려면 별도 시각 모델이 필요합니다
- 판이 0.2 대라 도구 규격이 바뀔 수 있습니다
- 특정 하네스 사용자는 다른 패키지를 써야 합니다
차별점
- 데스크톱 15개와 브라우저 23개 도구를 하나의 서버에 담았습니다.
- 상주 프로세스나 네트워크 서비스 없이 실행 파일 하나로 돕니다.
- 데스크톱과 브라우저 자동화에 API 키가 필요 없습니다.
- 문자 인식이 지역에서 돌아 화면 글자를 그냥 읽습니다.
워크플로
- 01전역으로 깝니다.
- 02MCP 클라이언트에 실행 파일을 지정합니다.
- 03화면과 창 목록을 읽습니다.
- 04마우스와 키보드로 조작합니다.
- 05브라우저는 크롬 제어 도구로 다룹니다.
주요 명령
| 명령 | 설명 |
|---|---|
npm install -g @nuphus/nuphus-mcp | 전역으로 설치합니다. |
nuphus-mcp | MCP 클라이언트가 이 이름을 실행하도록 설정합니다. |
함정
설치 전에 확인하세요
- 평범한 표준 입출력 MCP 서버이고 특정 하네스의 플러그인이 아닙니다. 그쪽 사용자는 전용 패키지를 깔아야 합니다.
- 화면을 읽어 판단하는 기능은 자기 시각 모델을 연결해야 동작합니다. 문자 인식만 지역에서 기본 제공됩니다.
- 화면과 키보드를 그대로 조작합니다. 권한 범위를 넓게 열면 위험이 큽니다.
- 판이 0.2 대이고 릴리스 본문에 변경 요약이 없습니다.
비교
화면 자동화 도구는 운영체제 하나에 묶이는 경우가 많습니다. 이쪽은 여러 운영체제를 하나의 실행 파일로 덮고 브라우저까지 같은 서버에 넣었습니다. 대신 판단이 필요한 부분은 별도 모델을 붙여야 합니다.
최근 변경
0.2.2 판은 릴리스 본문에 변경 요약을 남기지 않고 전체 변경 목록 링크만 걸어 두었습니다. 실제 내용은 커밋 비교로 확인해야 합니다.