💻 Claude가 컴퓨터를 제어할 수 있는 모델 컨텍스트 프로토콜 서버입니다. 이것은 컴퓨터 사용과 매우 유사하지만, 로컬에서 쉽게 설정하고 사용할 수 있습니다.

여기 클로드 하이쿠 4.5가 제 데스크탑 배경을 바꾸는 모습(4배속):

https://github.com/user-attachments/assets/cd0bc190-52c4-49db-b3bc-4b8a74544789

[! 경고] 작성 시점에서 모델은 자주 실수를 하며 프롬프트 인젝션에 취약합니다. 이 MCP 서버가 모델에게 컴퓨터의 완전한 제어권을 주기 때문에, 이는 큰 피해를 줄 수 있습니다. 따라서 이를 과잉행동 유아에게 컴퓨터에 접근권을 주는 것과 비슷하게 다루어야 합니다. 아마도 이를 면밀히 감독하는 것이 좋고, 샌드박스 사용자 계정에서만 하는 것을 고려할 것입니다.

설치

install-mcp의 지침을 따르면 MCP 클라이언트(Claude Code, Claude Desktop, Cursor, Cline, VS Code 등)에 맞는 적절한 설정을 생성해줍니다.

팁

이 방법은 바로 작동해야 합니다.

하지만 최상의 결과를 얻으려면:

• 컴퓨터 사용에 능숙한 모델을 사용하세요 - 최신 Claude 모델을 추천합니다.
• 작고 일반적인 해상도를 사용하세요 - 특히 720p가 잘 작동합니다. macOS에서는 displayoverride-mac을 사용하면 가능합니다.

computer-use-mcp

💻 A Model Context Protocol server for Claude to control your computer. This is very similar to computer use, but easy to set up and use locally.

Here’s Claude Haiku 4.5 changing my desktop background (4x speed):

https://github.com/user-attachments/assets/cd0bc190-52c4-49db-b3bc-4b8a74544789

[!WARNING] At time of writing, models make frequent mistakes and are vulnerable to prompt injections. As this MCP server gives the model complete control of your computer, this could do a lot of damage. You should therefore treat this like giving a hyperactive toddler access to your computer - you probably want to supervise it closely, and consider only doing this in a sandboxed user account.

Installation

Follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).

Tips

This should just work out of the box.

However, to get best results:

• Use a model good at computer use - I recommend the latest Claude models.
• Use a small, common resolution - 720p works particularly well. On macOS, you can use displayoverride-mac to do this. If you can’t use a different resolution, try zooming in to active windows.
• Install and enable the Rango browser extension. This enables keyboard navigation for websites, which is far more reliable than Claude trying to click coordinates. You can bump up the font size setting in Rango to make the hints more visible.

How it works

We implement a near identical computer use tool to Anthropic’s official computer use guide, with some more nudging to prefer keyboard shortcuts.

This talks to your computer using nut.js

Contributing

Pull requests are welcomed on GitHub! To get started:

1. Install Git and Node.js
2. Clone the repository
3. Install dependencies with npm install
4. Run npm run test to run tests
5. Build with npm run build

Releases

Versions follow the semantic versioning spec.

To release:

1. Use npm version to bump the version
2. Run git push --follow-tags to push with tags
3. Wait for GitHub Actions to publish to the NPM registry.