wimi321/macos-computer-use-skill

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

20 stars 10 forks 质量 72 趋势 10MIT

Repository Install

独立的MCP服务器，赋予AI代理对macOS的完全图形用户界面控制——截图、鼠标、键盘、应用、剪贴板和多显示器。零私有依赖。

概览

macOS 计算机使用技能独立 MCP 服务器，赋予 AI 代理对 macOS 的完全图形界面控制——截图、鼠标、键盘、应用、剪贴板和多显示——且无私有依赖。快速启动 ·工具 ·MCP 配置 ·爪中枢第一次启动时，服务器会自动创建 .runtime/venv 格式的 Python virtualenv，并安装所有运行时依赖。没有 Claude 桌面应用，没有私有原生模块。 macOS要求主机进程的权限。服务器启动时会检查两者，并通过MCP报告状态。请参阅示例/简易模板/mcp-config.json。这个项目作为一个自成一体的技能，涉及技能/计算机使用macOS。安装程序会将完整项目复制到 ~/.codex/skills/computer-use-macos/project——即使原始克隆被移除，技能依然能正常工作。 Python 依赖（pyautogui、mss、Pillow、pyobjc）在首次运行时会自动安装到隔离的虚拟环境中。

概述（AI 翻译）

简体中文 · 日本語

macOS 计算机使用技能独立的MCP服务器，赋予AI代理对macOS的完全图形界面控制——截图、鼠标、键盘、应用、剪贴板和多显示——且无私有依赖。

快速入门 · 工具 · MCP 配置 · 爪中心

特色

	特色	描述
视觉	截图与显示	捕捉任意显示，列举显示器，放大区域
输入	鼠标和键盘	点击、拖动、滚动、输入、按键组合、长按键——支持IME安全剪贴板路由
应用	应用控制	启动应用，检测最前面的应用，列出已安装/运行的应用，分层权限模型
剪贴板	读写	基于粘贴的工作流程的完整剪贴板访问
批处理	动作批处理	在单一MCP调用中串联多个动作以提升速度
运行时	零配置引导	首次运行时自动创建 Python virtualenv，并安装依赖
便携技能打包	作为独立技能的船只——安装一次，无需源代码仓库即可使用
公有的	无私有依赖	完全基于公包构建：节点。

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

简体中文 · 日本語

Features

	Feature	Description
Vision	Screenshot & Display	Capture any display, enumerate monitors, zoom into regions
Input	Mouse & Keyboard	Click, drag, scroll, type, key combos, hold keys — with IME-safe clipboard routing
Apps	Application Control	Launch apps, detect frontmost app, list installed/running apps, tiered permission model
Clipboard	Read & Write	Full clipboard access for paste-based workflows
Batch	Action Batching	Chain multiple actions in a single MCP call for speed
Runtime	Zero-Config Bootstrap	Auto-creates Python virtualenv and installs dependencies on first run
Portable	Skill Packaging	Ships as a standalone skill — install once, works without the source repo
Public	No Private Dependencies	Built entirely on public packages: Node.js, Python, pyautogui, mss, Pillow, pyobjc

Quick Start

1. Clone & build

git clone https://github.com/wimi321/macos-computer-use-skill.git
cd macos-computer-use-skill
npm install && npm run build

2. Run the MCP server

node dist/cli.js

On first launch the server automatically creates a Python virtualenv in .runtime/venv and installs all runtime dependencies. No Claude desktop app, no private native modules.

3. Or install from ClawHub

clawhub install computer-use-macos

[!NOTE] macOS requires Accessibility and Screen Recording permissions for the host process. The server checks both on startup and reports status through MCP.

Architecture

flowchart LR

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "computer-use": {
      "command": "node",
      "args": ["/absolute/path/to/macos-computer-use-skill/dist/cli.js"],
      "env": {
        "CLAUDE_COMPUTER_USE_DEBUG": "0",
        "CLAUDE_COMPUTER_USE_COORDINATE_MODE": "pixels"
      }
    }
  }
}