osa MCP

osa mcp

*让您的AI访问Mac上的每个可脚本化应用程序。*

osa-mcp是一个mcp服务器，可以自动发现所有可编写脚本的macOS应用程序（邮件、日历、查找器、音乐、笔记、Safari等），并为它们生成工具。没有配置，没有硬编码的应用程序列表。只需连接并离开。

你做什么

新巴拿马型船舶

claude mcp add my-mac -- npx -y osa-mcp

bunx

claude mcp add my-mac -- bunx osa-mcp

家酿

brew install MayCXC/osa-mcp/osa-mcp
claude mcp add my-mac -- osa-mcp

通过SSH远程访问Mac

如果你的AI在另一台机器上运行，请通过SSH连接到你的Mac。启用 在“系统设置”>“常规”>“共享”中进行远程登录 第一。

claude mcp add my-mac -- npx -y osa-mcp --ssh user@macbook.local

JSON配置

以上所有内容也可以直接添加到您的MCP设置文件中：

{
  "mcpServers": {
    "my-mac": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "osa-mcp"]
    }
  }
}

对于SSH，添加 "--ssh", "user@macbook.local" 到args。

你得到了什么

在典型的Mac上，osa mcp在大约4秒内生成大约700个工具。每个工具都包含从应用程序的脚本字典中提取的描述，因此您的AI知道每个工具的功能、所需的参数以及它们接受的值。

命令 让你的AI执行操作：

• mail_send, mail_reply, mail_forward
• finder_reveal, finder_move, finder_duplicate
• music_play, music_pause, music_search
• calendar_show, reminders_show, notes_show
• safari_do_javascript, safari_search_the_web
• messages_send, terminal_do_script

列表和获取 让你的AI读取数据：

• mail_list_messages, mail_get_message
• calendar_list_events, calendar_list_calendars
• finder_list_files, finder_list_disks
• notes_list_notes, reminders_list_reminders
• safari_list_tabs, safari_list_documents

应用属性 显示应用程序设置：

• mail_get_application 返回收件箱、提取间隔、主电子邮件等。
• finder_get_application 返回桌面、垃圾箱、主页、启动盘等。
• music_get_application 返回当前曲目、玩家状态等。

执行 对于生成的工具未涵盖的任何内容，运行任意AppleScript或JXA。

在对象层次结构中导航

许多工具接受 parent 用于导航到嵌套对象的参数：

// List events in a specific calendar
{ "parent": ["calendars", "byName", ["Work"]] }

// List messages in the inbox
{ "parent": ["inbox"] }

// Get the first window's current tab
{ "parent": ["windows", 0] }

路径步骤： "key" 访问房产， 0 按索引访问， [] 调用一个方法， ["arg"] 有争论的电话。

从源代码安装

git clone https://github.com/MayCXC/osa-mcp.git
cd osa-mcp
bun install
bun link
claude mcp add my-mac -- osa-mcp

需要 包子.

许可证

BSD 3-条款。看 许可证.