Mac Apps Launcher MCP Server 使用说明

项目简介

Mac Apps Launcher MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，旨在为 LLM 客户端提供在 macOS 系统上列出已安装的应用、启动应用以及使用指定应用打开文件的能力。通过此服务器，LLM 可以安全地与用户的 macOS 系统进行交互，实现应用管理和文件操作等功能。

主要功能点

列出应用: 可以获取 '/Applications' 目录下所有已安装的 macOS 应用程序列表。
启动应用: 允许 LLM 通过应用名称启动 macOS 应用程序。
打开文件: 支持使用指定的 macOS 应用程序打开特定的文件或文件夹。

安装步骤

安装 Node.js 和 npm: 确保您的 macOS 系统已安装 Node.js 和 npm (Node.js 包管理器)。
安装 MCP Server: 此 MCP Server 以 npm 包的形式发布。您无需手动下载仓库代码，只需在 Claude 的配置文件中指定即可。

服务器配置

要将 Mac Apps Launcher MCP Server 集成到支持 MCP 协议的 LLM 客户端（例如 Claude），您需要在客户端的 MCP 服务器配置中添加以下 JSON 配置信息。这段配置告诉客户端如何启动和连接到这个 MCP 服务器。

{
  "mcpServers": {
    "mac_apps_launcher": {  // 服务器名称，您可以自定义，例如 "mac_apps_launcher"
      "command": "npx",      // 启动服务器的命令，这里使用 npx 来运行 npm 包
      "args": [             // 启动命令的参数
        "y",                // 自动确认 npx 的安装提示 (yes)
        "@joshuarileydev/mac-apps-launcher-mcp-server" // 要运行的 npm 包名称，即 MCP 服务器的包
      ]
    }
  }
}

配置说明:

'"mac_apps_launcher"': 是您为这个 MCP 服务器自定义的名称，在客户端配置中用于标识和调用这个服务器。
'"command": "npx"': 指定了用于启动服务器的命令是 'npx'。'npx' 是 npm 包管理器自带的工具，用于方便地运行 npm 包的可执行文件，无需全局安装。
'"args": [...]': 是一个字符串数组，包含了传递给 'npx' 命令的参数。
- '"y"': 'npx' 在首次运行时可能会提示是否安装指定的 npm 包。添加 '"y"' 参数可以自动回答 "yes"，避免交互式提示，使服务器能够自动启动。
- '"@joshuarileydev/mac-apps-launcher-mcp-server"': 指定了要通过 'npx' 运行的 npm 包的名称。这是 Mac Apps Launcher MCP Server 的 npm 包名。

将以上 JSON 配置添加到您的 LLM 客户端（如 Claude）的 MCP 服务器配置文件中。 具体的配置文件位置和编辑方法请参考您使用的 LLM 客户端的文档。

基本使用方法

配置完成后，LLM 客户端将能够通过 MCP 协议与 Mac Apps Launcher MCP Server 通信。您可以通过自然语言指示 LLM 使用以下功能：

列出应用: 例如，您可以询问 LLM "列出我电脑上安装的应用" 或 "有哪些应用可以启动？"。LLM 客户端会调用 'list_applications' 工具，并返回应用列表。
启动应用: 例如，您可以指示 LLM "启动 Safari 浏览器" 或 "打开 Pages 应用"。LLM 客户端会调用 'launch_app' 工具，并尝试启动指定名称的应用。
打开文件: 例如，您可以指示 LLM "用 Preview 打开这个 PDF 文件" (并提供文件路径)。LLM 客户端会调用 'open_with_app' 工具，并尝试使用指定的应用打开文件。

请注意: 具体的使用方式和指令取决于您使用的 LLM 客户端的功能和设计。您需要参考 LLM 客户端的文档，了解如何利用配置的 MCP 服务器来扩展 LLM 的能力。

关键词