Ghost Os

MCPAI代理

提供方 ghostwright

AI代理 未标注 无需鉴权 社区 / 第三方 ClaudeCursorVS Code

Ghost OS是一个为AI代理设计的操作系统,使AI代理能够通过macOS的可访问性树和本地视觉模型来查看和操作Mac上的任何应用程序,包括自我学习工作流程和本地数据处理。

一句话选型结论

按资料字段整理

Ghost Os 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude、Cursor、VS Code,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 1,453 仓库热度,无公开仓库时显示未标注
工具数 29 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量29暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Swift本地部署AI代理macOS自动化自我学习本地处理可访问性树

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 29 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 29 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude、Cursor、VS Code,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。
  • 仓库有一定关注度(星标 1,453),遇到问题更容易搜到资料。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Ghost Os当前 29 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ghostwright上游标注的维护方 ghostwright
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.5 KB
来自项目仓库与上游目录的原文,未做删改

Ghost OS

Full computer-use for AI agents.


你的AI代理可以编写代码、运行测试、搜索文件。但它不能点击按钮、发送电子邮件或填写表格。它位于聊天框内。

Ghost OS改变了这一点。只需安装一次,任何AI代理都可以查看和操作Mac上的每个应用程序。

遇见 幽灵

Ghost OS为AI代理提供了眼睛和手。阴影给了他们记忆。斯佩克特给了他们一个家。

在90秒内将持久AI代理部署到专用VM。自动DNS、TLS、系统强化。交互式TUI仪表板。你拥有基础设施。

赢得您信任的AI代理。

遇见 影子

影子是故事的另一半。Ghost OS为AI代理提供了在Mac上的眼睛和手。阴影赋予他们记忆和智慧。

14模态捕捉。积极的建议。剧集生成。设备上LLM推理。计算机使用训练数据。都是本地的,都是开源的。

你的电脑一直在专心。


最新动态

自学食谱。 向Ghost OS展示如何做一次,它就会永远记住。

  • ghost_learn_start --开始观察用户执行任务
  • ghost_learn_stop --停止并返回丰富的动作序列
  • ghost_learn_status --检查录制进度

用户手动执行任务(单击、键入、切换应用程序)。Ghost OS通过一个富含可访问性树上下文的CGEvent点击来观察每一个操作。克劳德将原始观察结果综合成一个参数化的、可回放的配方。

无需截图。没有视觉模型。只有辅助功能树和键盘/鼠标。```
User: "Watch me send an email."
Agent: ghost_learn_start task_description:"send email in Gmail"
...user performs the task...
Agent: ghost_learn_stop
-> 8 actions with full AX context
-> Synthesizes recipe with 3 parameters: recipient, subject, body
-> ghost_recipe_save
User: "Send an email to bob about the Q4 report"
Agent: ghost_run recipe:"gmail-send-learned" params:{...}


需要输入监控权限(系统设置>隐私和安全>输入监控)。跑 `ghost setup` 配置。

Previous: v2.1.2

4个新工具。ghost_annotate、ghost_hover、ghost_long_press、ghost_drag。固定视觉sidecar依赖关系,固定视觉模型下载,中文/CJK输入支持(谢谢 @俊世5218).

感谢500多名主演这个项目的人。你是我们继续建设的原因。如果你想直接捐款,我们很乐意。看 贡献.md.```
You:     "Send an email to sarah@company.com about the Q4 report"
Agent:   ghost_run recipe:"gmail-send" params:{recipient, subject, body}
→ Compose opens, fields fill, email sends. Done.

设置

食谱在行动

发送电子邮件和下载论文。任何应用程序。任何工作流。

浏览器之外

Slack消息、Finder文件夹——Ghost OS操作本机macOS应用程序,而不仅仅是浏览器。

为什么选择Ghost OS?

其他电脑使用工具会截图并猜测屏幕上的内容。Ghost OS读取macOS可访问性树——每个应用程序中每个元素的结构化、标记数据。当AX树不够时(web应用程序、动态内容),它会回退到本地视觉模型(ShowUI-2B)进行视觉基础。

当它计算出一个工作流程时,它会保存它。其他工具每次都会重复同样昂贵的推理。

  • 自我学习 --前沿模型一次性计算出工作流。一个小模型永远运行它。
  • 透明 --食谱是JSON。跑步前仔细阅读每一步。没有黑盒子。
  • 本土的 --可访问性树优先。必要时进行视觉回退。基于像素猜测的结构化数据。
  • 任何应用程序 --不仅仅是浏览器。Slack、Finder、Messages——Mac上的任何东西。
  • 本地 --你的数据永远不会离开你的机器。
  • 打开 --MCP协议。适用于Claude Code、Cursor、VS Code或任何MCP客户端。

Ghost OS · 人类计算机使用 · OpenAI运算符 · OpenClaw
👀 · 它怎么看 · 可访问性树+本地VLM · 仅截图 · 仅截图 · Browser DOM
🖥️ · 原生应用 · 任何macOS应用程序 · 任何(通过像素) · 仅浏览器 · 仅浏览器
🧠 · 学习工作流程 · JSON食谱 · 否 · 否
🔒 · 数据保持本地 · 是 · 取决于设置 · 否(云) · 是
📖 · 开源 · 麻省理工学院 · 否 · 否 · 麻省理工

安装```bash

brew install ghostwright/ghost-os/ghost-os
ghost setup


就这样 `ghost setup` 处理权限、MCP配置、配方安装和视觉模型设置。

macOS beta? Use the manual install instead.

Homebrew在macOS开发者测试版上有一个已知的问题,它需要一个尚不存在的Xcode版本。如果 `brew install` 失败,直接安装:```bash
curl -sL https://github.com/ghostwright/ghost-os/releases/latest/download/ghost-os-2.2.1-macos-arm64.tar.gz | tar xz
sudo cp ghost /opt/homebrew/bin/
sudo cp ghost-vision /opt/homebrew/bin/
sudo mkdir -p /opt/homebrew/share/ghost-os
sudo cp GHOST-MCP.md /opt/homebrew/share/ghost-os/
sudo cp -r recipes /opt/homebrew/share/ghost-os/
sudo cp -r vision-sidecar /opt/homebrew/share/ghost-os/
ghost setup

运作原理

Ghost OS通过以下方式连接到您的AI代理 主控程序 并为它提供了29个工具来查看和操作你的Mac。它读取macOS可访问性树,以获取有关每个应用程序的结构化数据。对于AX树不足的web应用程序(Gmail、Slack),本地视觉模型(ShowUI-2B)可以直观地找到元素。单击、键入、悬停、拖动、滚动、按键、管理窗口。任何应用程序,而不仅仅是浏览器。```
You: "Download the latest paper on chain-of-thought prompting from arXiv"
Agent: ghost_run recipe:"arxiv-download" params:{query:"chain of thought prompting"}
→ Navigates to arXiv, searches, opens PDF, downloads to Desktop. Done.


适用于Claude Code、Cursor、VS Code或任何讲MCP的东西。

## 菜谱

当你的代理想出一个工作流时,它会将其保存为食谱。配方是一个包含步骤、参数和等待条件的JSON文件。透明且可审计。

**前沿模型一次性计算出工作流。一个小模型永远运行它。**```bash
# One command sends an email
ghost_run recipe:"gmail-send" params:{"recipient":"hello@example.com","subject":"Hello","body":"World"}

# 7 steps, 30 seconds, 100% reliable
  • 食谱只是JSON。跑步前仔细阅读每一步。
  • 与您的团队分享。一个人学习工作流程,每个人都会受益。
  • 把食谱连在一起。代理人知道什么时候打电话。
  • 用克劳德或GPT-4写一次。和俳句一起永远奔跑。

29工具

工具 它的作用
🔍 ghost_context 获取当前应用程序、窗口标题、URL、焦点元素和屏幕上的所有交互元素
🔍 ghost_state 列出每个正在运行的应用程序及其窗口、位置和大小
🔍 ghost_find 在整个UI中按名称、角色、DOM id或CSS类搜索元素
🔍 ghost_read 从任何应用程序中提取文本内容,并对嵌套内容进行深度控制
🔍 ghost_inspect 获取一个元素的完整元数据:角色、位置、动作、DOM id、可编辑状态
🔍 ghost_element_at 识别特定屏幕坐标处的元素
📸 ghost_screenshot 捕获窗口截图以进行可视化调试
📸 ghost_annotate 交互式元素上带有编号标签和点击坐标的屏幕截图
👁️ ghost_ground 使用视觉(ShowUI-2B)查找元素坐标。当AX树找不到web元素时有效
👁️ ghost_parse_screen 通过视觉检测所有交互元素
🎯 ghost_click 按名称、DOM id或屏幕坐标单击元素
🎯 ghost_hover 将光标移动到元素或位置以触发工具提示和悬停效果
🎯 ghost_long_press 按住可进入上下文菜单、强制触摸预览和拖动启动
🎯 ghost_drag 从一个点拖动到另一个点,用于文件移动、滑块、列表重新排序、文本选择
⌨️ ghost_type 按名称或当前光标在特定字段中键入文本
⌨️ ghost_press 按一个键,如回车键、Tab键、Esc键或箭头键
⌨️ ghost_hotkey 按组合键,如Cmd+L、Cmd+Return、Cmd+Shift+P
🎯 ghost_scroll 在任何应用程序窗口中向上、向下、向左或向右滚动
🪟 ghost_focus 将任何应用程序或特定窗口带到前面
🪟 ghost_window 最小化、最大化、关闭、移动或调整任何窗口的大小
⏳ ghost_wait 等待URL更改、元素出现或消失或标题更改
📦 ghost_recipes 列出所有已安装的配方及其说明和参数
▶️ ghost_run 执行带有参数替换的配方
📦 ghost_recipe_show 查看配方的完整步骤和配置
📦 ghost_recipe_save 从JSON安装新配方
📦 ghost_recipe_delete 删除已安装的配方
🎓 ghost_learn_start 开始观察用户的操作以进行工作流学习
🎓 ghost_learn_stop 停止观察并返回丰富的动作序列
🎓 ghost_learn_status 检查学习模式是否处于活动状态并记录统计数据

诊断```bash

$ ghost doctor

[ok] Accessibility: granted
[ok] Screen Recording: granted
[ok] Input Monitoring: granted (for learning mode)
[ok] Processes: 1 ghost MCP process
[ok] MCP Config: ghost-os configured
[ok] Recipes: 5 installed
[ok] AX Tree: 12/12 apps readable
[ok] ghost-vision: /opt/homebrew/bin/ghost-vision
[ok] ShowUI-2B model: ~/.ghost-os/models/ShowUI-2B (3.0 GB)
[ok] Vision Sidecar: not running (auto-starts when needed)

All checks passed. Ghost OS is healthy.


## 从源代码构建```bash
git clone https://github.com/ghostwright/ghost-os.git
cd ghost-os
swift build
.build/debug/ghost setup

需要Swift 6.2+和macOS 14+。

建筑```

AI Agent (Claude Code, Cursor, any MCP client)
│
│ MCP Protocol (stdio)
│
Ghost OS MCP Server (Swift)
│
├── Perception ──── see what's on screen (AX tree)
├── Vision ──────── visual grounding (ShowUI-2B, local)
├── Actions ─────── click, type, scroll, keys
├── Recipes ─────── self-learning workflows
└── AXorcist ────── macOS accessibility engine
```

约7000行Swift+Python视觉侧车。建立在 AXorcist 通过 @施泰皮特.

贡献

看 贡献.md。我们需要更多应用程序的配方、不同设置下的测试和错误报告。如果你正在构建可以做真实事情的人工智能代理,这就是这个项目。

贡献者

感谢所有为Ghost OS做出贡献的人。

许可证

麻省理工学院

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Ghost Os 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Ghost Os 怎么在 Claude、Cursor、VS Code 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Ghost Os 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Ghost Os 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Ghost Os 支持哪些客户端?

资料标注支持 Claude、Cursor、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Ghost Os 能提供哪些能力?

资料显示约 29 个工具;能力标签包括 Swift、本地处理、Claude、自我学习。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。