如何在 Mac 上向 Raycast 添加 MCP 服务器

LMCP 在你的设备上执行本地工具。云端 AI 提供商和已连接的服务可能会收到请求的数据；适用其各自条款。

为什么要向 Raycast 添加 MCP 服务器？

Raycast 是 Mac 进阶用户日常使用的启动器：按一下键，就能搜索、切换应用或计算。Raycast AI 将聊天模型带入同一个窗口 — 但默认情况下，模型只能对话，无法看到你的收件箱、日历或文件。

MCP（Model Context Protocol）弥补了这一缺口。MCP 服务器将真实操作 — “搜索我的邮件”、“列出今天的日程”、“找到那份 PDF” — 作为 AI 可以调用的工具开放出来。向 Raycast 添加一个 MCP 服务器后，Quick AI 就不再只是聊天机器人，而是能操作 Mac 的助手。

问题在于，大多数 MCP 服务器只覆盖单个应用，因此要搭建实用的配置，就得安装和维护五六个服务器。LMCP 采用相反的方式：一个签名安装程序、一个服务器、覆盖约 24 个应用领域的 201+ 个工具 — 同一套安装也服务于 Claude Desktop、Cursor 和 VS Code，因此 Raycast 无需单独搭建。

你需要准备什么

• macOS 13（Ventura）或更高版本 — Apple Silicon 或 Intel
• Raycast 和 Raycast Pro — 自定义 MCP 服务器属于 AI（Pro）功能
• Node.js — Raycast 通过 stdio 使用 npx 启动 LMCP
• LMCP — 约 30 秒安装完成（见下一步）

对于连接的应用，你不需要 API 密钥、OAuth 令牌或额外账户。LMCP 通过 macOS 原生 API 与 Mail.app、Calendar、Messages 等应用通信，因此 Mac 上已经设置好的内容，就是 AI 能够使用的内容。

第 1 步：在 Mac 上安装 LMCP

下载应用（macOS 13+）并运行安装程序。无论采用哪种方式，LMCP 都会出现在菜单栏中，Claude Desktop 和 Cursor 等桌面客户端也会自动完成配置。

curl -fsSL 'https://local-mcp.com/install?ref=guide-raycast-mac' | bash

首次使用时，macOS 会要求你授予 LMCP 访问各个应用（Mail、Calendar 等）的权限。点击“Allow” — 这种逐个应用授权的方式就是安全机制：未经你批准，任何内容都无法访问。

第 2 步：将 LMCP 添加到 Raycast

1. 打开 Raycast，运行 Manage MCP Servers 命令。
2. 按 Cmd + N 添加服务器，然后粘贴以下 JSON：

{
  "command": "npx",
  "args": ["-y", "local-mcp@latest"]
}

提交表单。Raycast 使用 npx 通过 stdio 启动服务器，这就是需要安装 Node.js 的原因。@latest 标签意味着 Raycast 始终启动当前发布版本 — 无需手动更新。

第 3 步：试用

打开 Raycast AI（Quick AI 或 AI Chat），然后询问：

列出我的邮件账户

Raycast 会调用 Mac 上的工具并返回结果，全程无需离开启动器。接下来，可以尝试这些日常实用指令：

• “总结我的未读邮件” — 在启动器窗口中对收件箱进行优先级梳理。
• “今天我的日历上有什么？” — 直接读取 Calendar.app。
• “在我的下载文件夹中找到关于 Q3 合同的 PDF” — 搜索你的真实文件。
• “给 Ana 发消息，说我会迟到 10 分钟” — 起草 iMessage，并在发送前向你展示。
• “今天上午我在 Teams 上错过了什么？” — 帮你了解频道和聊天中的最新情况。

在授权会改变状态的工具之前，请查看该工具针对当前平台的最新预览和确认要求。这些保护措施因工具和 AI 客户端而异。

Raycast AI 配合 LMCP 可以做什么

一个服务器，201+ 个工具。大家在启动器中最常用的领域包括：

• Mail — 列出、读取、搜索、发送、回复、移动邮件和保存附件（Mail.app 中的任何账户：Gmail、iCloud、Outlook、Exchange、IMAP）
• Calendar — 列出多个日历中的日程，创建、更新和删除日程
• Messages — 读取和搜索 iMessage 对话、发送消息
• 文件与 Finder — 搜索、列出、读取和写入文件及文件夹
• Notes 与 Reminders — 创建和搜索备忘录、管理提醒事项列表
• Contacts — 查找联系人、电话号码和地址
• Microsoft 365 — Outlook 邮件和日历、Teams 频道与聊天、OneDrive 文件
• Office 文档 — 读取和创建 Excel、Word、PowerPoint 文件；读取 PDF
• WhatsApp 与 Slack — 在已连接的服务中读取、搜索和发送

由于每个工具都在同一个会话中运行，Raycast AI 可以将它们串联起来：读取一封邮件、检查日历冲突、起草回复 — 一条指令、三个应用，无需切换窗口。

支持哪些账户和应用？

LMCP 连接的不是服务，而是你 Mac 上的应用，并继承这些应用中已有的所有账户：

• 电子邮件 — Mail.app 中配置的每个账户：Gmail、iCloud、Outlook.com、Exchange / Microsoft 365 或任何 IMAP 提供商。多个账户可以同时使用，你也可以指定使用哪一个（“从我的工作邮箱发送”）。
• Calendar — Calendar.app 中可见的每个日历，包括订阅和共享日历。
• Messages — 在这台 Mac 上已登录账户的 iMessage 对话。
• Microsoft 365 — Outlook、Teams 和 OneDrive 使用你现有的工作账户连接。

只要你能在 Mac 上看到，Raycast AI 就能访问 — 无需另外核对“支持的提供商”名单，因为应用本身就是集成。

一个服务器与多个单应用服务器的对比

搜索适用于 Raycast 的 MCP 服务器时，可以找到很多可靠的单一用途项目 — Apple Mail 服务器、Calendar 服务器、文件系统服务器。它们能正常工作，如果你喜欢自己组合配置，它们也是不错的选择。以下是客观对比：

简而言之：如果你想为单个应用搭建精简且可自行修改的配置，可以选择单一用途服务器。如果你想通过一次两分钟的安装让整个 Mac 都能被 Raycast AI 使用，则选择 LMCP — 同一个服务器也已经连接到你使用的其他每个 MCP 客户端。

本地工具与数据边界

• LMCP 作为本地服务器在你的电脑上运行；Raycast 通过 stdio 启动它
• 它通过 macOS 原生 API 读取应用 — 不进行网页抓取，也不进行云端同步
• 工具结果从 Mac 返回你正在进行的 AI 对话 — 基于云端的 AI 提供商会根据其自身的数据处理条款接收请求的结果
• 在任何工具访问应用之前，每个应用都需要明确获得 macOS 权限授权

没有 API 密钥和 OAuth，也意味着没有可能泄露的第三方令牌。你的邮件、日程和文件仍在原来的位置 — 在应用中，在你自己的电脑上。

在启动器中充分利用 MCP 工具

启动器适合简短指令，而简短指令有时会让模型不确定该凭记忆回答还是调用工具。三个习惯能带来不同：

• 明确说明是你的数据。“检查我的日历”和“搜索我的邮件”表明答案在你的 Mac 上，而不是模型的通用知识中。
• 在一条指令中串联操作。一个服务器提供 201+ 个工具的意义在于，单个请求可以跨越多个应用：“找到发票邮件，将附件保存到桌面，并添加一个提醒，让我周五付款”。三个工具，一次按键。
• 充分利用预览。任何发送、移动或删除操作都会准确展示即将发生的事情。确认无误时可以迅速同意 — 但一定要读，因为预览是让启动器级别的快速工作流仍然安全的保障。

故障排查

没有“Manage MCP Servers”命令

自定义 MCP 服务器属于 Raycast AI 功能，需要 Raycast Pro。在 Raycast Settings 中升级，然后再次搜索该命令。

服务器无法启动

通常有两个原因：LMCP 应用没有运行（检查菜单栏图标；如果没有，请从“应用程序”启动它），或者 npx 不在 Raycast 使用的 PATH 中。从 nodejs.org 安装 Node.js 会将其放到标准位置；安装后，删除并重新添加服务器条目。

还有一种不太明显的情况：通过 nvm 安装的 Node 依赖 shell 配置文件，而 Raycast 这样的图形界面应用不会读取该文件 — 因此 npx 在终端里能运行，从 Raycast 启动却仍然失败。可靠的解决办法是进行系统级 Node 安装（使用官方安装程序或 Homebrew）。

AI 没有使用工具就回答了

问一个明确需要你自己数据的问题（“列出我的邮件账户”、“今天我的日历上有什么？”）。如果模型仍然凭记忆回答，请检查 Manage MCP Servers 中 LMCP 条目是否显示为运行中，并开始一个新的 AI 聊天。

工具返回权限被拒绝的错误

macOS 要求每个应用都获得明确授权。前往 System Settings > Privacy & Security > Automation，确保 LMCP 有权访问工具所需的应用（Mail、Calendar、Messages 等）。首次调用每个应用时通常会弹出授权提示；如果你关闭了提示，可以在这里修正。

实际工作流

可直接粘贴到 Quick AI 的指令：

不打开 Mail 就整理收件箱

启动器成为你早晨整理消息的入口：还没打开任何窗口，邮件就已读完、排好优先级，并起草好了回复。

一次按键完成会议准备

一次查询邮件、Notes 和 Reminders，并汇总成简报 — 这种跨应用操作链是单一用途服务器无法完成的。

找到并发送

一条指令完成文件搜索和邮件撰写。发送任何内容之前，LMCP 都会向你展示待发送邮件供你确认。

一周结束时的摘要

一周分散的对话浓缩为一篇备忘录 — 创建在你真正存放备忘录的地方，而不是一个日后找不到的聊天窗口里。

LMCP 还能做什么？

同一套安装服务于你使用的每个 MCP 客户端。查看使用 Claude 操作 Apple Mail、无需 OAuth 的 Calendar 连接、无需 API 密钥的 Microsoft Teams 连接，或浏览完整指南列表，了解 201+ 个工具可以访问的所有内容。

常见问题

如何向 Raycast 添加 MCP 服务器？

在 Raycast 中运行 Manage MCP Servers 命令，按 Cmd+N，然后粘贴 { "command": "npx", "args": ["-y","local-mcp@latest"] }。自定义 MCP 服务器需要 Raycast Pro。

使用 MCP 服务器需要 Raycast Pro 吗？

需要。自定义 MCP 服务器属于 Raycast AI（Pro）功能。LMCP 在本地运行 — 同一套安装也适用于 Claude Desktop、Cursor 和 VS Code 等客户端。

Raycast AI 配合 LMCP 可以做什么？

LMCP 为 Raycast AI 提供 201+ 个 Mac 本地工具，涵盖 Mail、Calendar、Contacts、iMessages、Notes、Reminders、Files、Microsoft Teams、OneDrive、Office 文档等 — 全部在 Mac 上运行，可以在一条指令中串联使用。

需要 API 密钥或应用密码吗？

不需要。LMCP 通过 macOS 原生 API 访问应用，因此 Mac 上已经配置好的所有内容 — 每个 Mail 账户、日历和聊天 — 都无需密钥、OAuth 或密码即可使用。macOS 会要求你逐个应用明确授予权限。

我的数据会进入云端吗？

LMCP 执行本地工具，并将请求的结果返回给 AI 客户端。Raycast 背后的模型会处理这些结果。如果它基于云端运行，其提供商会根据自身的数据处理条款接收这些内容。

现成配方

使用相同工具、可直接复制粘贴的工作流：

• 让 AI 为你的下一场会议做好准备
• 找出 WhatsApp、Slack、Teams 和邮件中所有未回复的客户请求
• 在日程冲突造成问题之前发现并解决

相关指南

• 让 AI 访问 Mac 上的邮件
• 将 AI 连接到 Mac 日历 — 无需 OAuth
• 让 Cursor 访问邮件、日历和联系人
• AI 能在不将邮件发送到云端的情况下读取邮件吗？
• 在 Mac 上设置 Warp MCP
• 在 Mac 上设置 Zed MCP
• 在 Mac 上设置 VS Code MCP