macuse

Macuse — 为每款 Mac 应用注入 AI 超能力

通过 Model Context Protocol，让 AI 直接控制 Calendar、Mail、Notes、Reminders、Messages 及其他任何 Mac 应用——适用于 Mac 的 MCP 服务，搭配 macOS 电脑使用功能，完全在设备本地运行。

支持 Claude Desktop、Cursor、Codex、Raycast、VS Code、Warp、Zed、LM Studio、Windsurf，以及任何兼容 MCP 的客户端。

此仓库为 Agent 客户端打包 Macuse：Claude Desktop .mcpb 安装包，以及适用于 Claude Code 和 Codex 的Agent 插件。macOS 应用本身和完整文档请访问 macuse.app。

你使用的应用	安装此项	获取内容
Claude Code、Codex	Agent 插件	MCP 工具 + 技能
Claude Desktop	.mcpb bundle	MCP 工具
Cursor、Raycast、VS Code、Zed 等	直接命令	MCP 工具

这三种方式都连接到同一个本地服务。插件还会安装技能——这些说明会教 Agent 如何正确使用工具，无需通过反复试错来摸索参数格式。

Macuse 的功能

让 AI 在 Mac 上工作的两种互补方式。所有操作都在本地运行——你的数据不会离开设备。

原生应用集成

AI 可以通过自然对话直接读取和写入 macOS 应用。

工具箱	你可以这样提问
Calendar	“安排下周二下午 3 点开会”、查找空闲时间、管理日程
Mail	“为这封邮件起草回复”、搜索收件箱、整理邮件
Notes	“查找提到第二季度发布计划的笔记”、记录灵感、在笔记中追加内容
Reminders	创建带截止日期和优先级的任务、标记为已完成、搜索所有列表
Messages	读取和发送 iMessage、搜索对话
Stickies	在 Apple Stickies 中搜索、读取和创建便笺
Contacts	按姓名、邮箱、电话或公司查找联系人
Maps & Location	搜索地点、查询路线和行程时间、获取当前位置
Shortcuts	浏览已安装的快捷指令，并运行它们（可选输入）

在 macOS 上使用电脑

查看并控制任何 Mac 应用——包括没有专用集成的应用。Macuse 将电脑使用功能带到 macOS，适用于任何 MCP 客户端，而不仅仅是 Claude 或 Codex。

• 点击任意元素、输入文本、浏览菜单、操作任何应用
• 填写网页表单、使用企业软件、自动化调用不存在的 API
• 在后台运行——AI 在另一款应用中工作时，你的光标和活动窗口保持不动

安装为 Agent 插件

适用于 Claude Code 和 Codex。打包 MCP 服务和三个技能，让 Agent 预先了解工作流、参数格式以及权限错误的恢复方法。

1. 安装 Macuse： 从 macuse.app/download 下载，将 Macuse.app 拖到 /Applications，然后启动一次

2. 添加市场并安装：

   Claude Code

   /plugin marketplace add macuse-app/macuse-mcp
   /plugin install macuse@macuse-plugins
   

   Codex

   codex plugin marketplace add macuse-app/macuse-mcp
   codex plugin add macuse@macuse-plugins
   

3. 批准 OAuth： 首次调用工具时，在 Macuse 窗口中批准授权提示

如果工具没有立即显示，请重启会话（或在 Claude Code 中运行 /reload-plugins）。如果应用不在 /Applications，请设置 MACUSE_BINARY。

包含的技能

技能	涵盖内容
macuse-setup	安装、连接客户端、授予 macOS 权限、诊断配置故障
macuse-apps	Calendar、Mail、Reminders、Notes、Messages、Location——路由、参数格式、工作流顺序
macuse-computer-use	操作任意 Mac 应用的图形界面——检查／操作／验证循环、元素定位、错误恢复

Agent 仅在任务需要时加载技能。详情请参阅 plugins/macuse/README.md。

Codex 用户： 由于 Codex 会自动拒绝来自第三方 MCP 服务的授权提示，写入操作目前会失败 （openai/codex#18896）。读取 操作正常。

为 Claude Desktop 安装

Claude Desktop 不直接支持远程 http:// 连接器，因此此 .mcpb 是一键安装程序。其他 MCP 客户端请参阅下文的与其他客户端配合使用。

1. 安装 Macuse：
   • 从 macuse.app/download 下载
   • 将 Macuse.app 拖到 /Applications 并启动
   • 授予应用提示的权限
2. 安装捆绑包： 从 Releases 下载 macuse.mcpb，然后双击，在 Claude Desktop 中打开
3. 批准 OAuth： 批准弹出的授权提示，即可完成连接

如需卸载，请在 Claude Desktop 设置中移除该条目。

与其他客户端配合使用

对于接受自定义命令的客户端（Cursor、Codex、Raycast、VS Code、Warp、Zed、LM Studio、Windsurf、ChatWise 等），请跳过此捆绑包并直接配置：

{
  "mcpServers": {
    "macuse": {
      "command": "/Applications/Macuse.app/Contents/MacOS/macuse",
      "args": ["mcp"]
    }
  }
}

各客户端的设置指南：macuse.app/docs/clients。

隐私与权限

• 仅限本地。 所有处理都在你的 Mac 上进行。无云端服务，也不会遥测你的内容。
• 按应用设置权限。 可为每个 AI 客户端访问的每个应用选择允许、拒绝或一次性批准。密码管理器和银行应用等敏感应用每次都会要求重新确认。撤销 AI 客户端的授权会自动清除其应用权限。
• 按客户端设置 OAuth。 每个 MCP 客户端都有独立的授权，可在 Macuse 设置中管理。

工作原理

所有安装方式都只是同一功能的轻量封装：macuse mcp，即内置于 Macuse macOS 应用中的 CLI。所有 MCP 协议处理、OAuth、权限和重新连接都由应用负责。

• .mcpb 捆绑包是一个约 130 行代码的 Node stdio 封装程序，它会启动 macuse mcp 并通过 stdin/stdout 转发 JSON-RPC。它的存在仅仅是因为 Claude Desktop 尚不直接支持 http:// 远程连接器。
• 插件完全跳过 Node——由 shell 启动器执行同一个二进制文件，并额外提供技能。

使用 MACUSE_BINARY 环境变量覆盖二进制文件路径 （可在 Claude Desktop 捆绑包界面中配置）。默认值： /Applications/Macuse.app/Contents/MacOS/macuse。

仓库结构

.claude-plugin/marketplace.json   Claude Code marketplace catalog
.agents/plugins/marketplace.json  Codex marketplace catalog
plugins/macuse/                   The plugin — manifests, launcher, skills
src/, bin/                        Node stdio wrapper for the .mcpb bundle
manifest.json                     .mcpb bundle manifest (Claude Desktop)
server.json                       MCP Registry entry

两个市场都指向此仓库中的 plugins/macuse，因此一次推送即可更新所有渠道。发布时，package.json、manifest.json 和两个插件清单中的版本字符串会由 scripts/sync-manifest-version.js 同步。

推送前请验证插件更改：

claude plugin validate ./plugins/macuse --strict   # plugin manifest
claude plugin validate . --strict                  # marketplace catalog

要求

• macOS 13.0（Ventura）或更高版本——Apple Silicon 或 Intel
• 已安装 Macuse macOS 应用
• 仅 .mcpb 捆绑包需要 Node 20.8.1+（由 Claude Desktop 的运行时捆绑）；插件不依赖 Node

链接

• 网站：macuse.app
• 下载：macuse.app/download
• 文档：macuse.app/docs
• 定价：macuse.app/pricing — 提供每日限额的免费套餐，或一次性购买 Lifetime
• MCP 规范：modelcontextprotocol.io

许可证

此 MCPB bundle 基于 MIT 许可证授权。Macuse macOS 应用是单独的商业产品，详情请参阅 macuse.app。