Mac 本地 MCP 服务器:提醒事项、邮件与系统指标

最后更新: 2026-11-14

Emerald Tools 是一款适用于 macOS 14.0 或更高版本的菜单栏应用,内置了一个 MCP 服务器。打开它并把它的连接器注册到你的 MCP 客户端之后,连接的 AI 代理就可以处理你的提醒事项,搜索和阅读你的邮件并准备由你亲自发送的邮件,还可以读取应用记录的系统指标历史。代理究竟能访问其中哪些服务,以及每个工具的调用是静默运行、等待你批准还是被拒绝,都由你决定。客户端只在你的 Mac 上与应用通信,不会打开任何网络端口。

代理单独工作时

  • 聊天或编程代理没有直接进入你 Mac 上的应用和数据的途径,例如“提醒事项”或你的邮箱。
  • 让代理“把这个加到我的提醒事项里”或“回复那封邮件”,最后得到的是一段需要你自己复制过去的文字。
  • 任何能够弥补这一差距的东西,都必须被托付它能接触到的一切,而且是一次性全部托付。

Emerald Tools 中的 MCP 服务器

  • 为连接的代理提供按服务分组的工具:提醒事项、邮件和系统指标。每项服务都可以整体关闭。
  • 让你把每个工具设为始终允许、询问或拒绝。读取默认为始终允许;任何会更改内容的操作默认为询问。
  • 设为询问时显示确认面板,列出代理的名称和确切的参数,30 秒后自动取消。
  • 在关键之处把最后一步留给你:代理不能删除提醒事项,也不能发送邮件。
  • 让客户端连接留在你的 Mac 上:代理的客户端通过随附的连接器与正在运行的应用通信,不会打开任何网络端口。

如何把 AI 代理连接到 Emerald Tools

  1. 打开 MCP 服务器点击菜单栏中的 Emerald Tools 图标,选择“打开仪表盘...”。在边栏“支持工具”标题下选择“MCP 服务器”,然后打开页面顶部的 Emerald Tools MCP。在你这样做之前,服务器保持关闭;关闭期间,任何代理都无法连接。
    Emerald Tools 仪表盘中的“MCP 服务器”页面,顶部的“Emerald Tools MCP”开关已打开,下方的“连接客户端”卡片显示了一条 claude mcp add 命令和供其他客户端使用的 JSON 条目,每项旁边都有“拷贝”按钮。图片显示的是英文界面。
  2. 在你的 MCP 客户端中注册连接器“连接客户端”卡片显示适用于 Claude Code 的完整命令行,其中已经填好了你这份应用中连接器的路径;“拷贝”按钮会把它放到剪贴板上,可以直接粘贴到“终端”中。它会为所有文件夹注册服务器,而不只是你运行命令的那个文件夹。其他支持 stdio 服务器的 MCP 客户端会在它们自己的配置文件中以 JSON 条目的形式使用同一个连接器,第二个“拷贝”按钮会给你这个条目。代理使用时请保持 Emerald Tools 运行,如果你移动了应用或更改了它的名称,请重新注册。
  3. 选择代理可以使用的服务在“工具组”下,“提醒事项”“系统指标”和“邮件”各有一个打开或关闭整项服务的开关,以及一个打开其页面的箭头。只打开你希望代理访问的服务。由于你的邮件可能包含个人信息或其他敏感信息,“邮件”在打开前会请你确认,而且必须先在它的页面上添加至少一个邮件账户,代理才能使用它。
    “MCP 服务器”页面中的“工具组”卡片,列出了“提醒事项”“系统指标”和“邮件”,每项都有一个开关和一个打开其页面的箭头;“邮件”已打开。图片显示的是英文界面。
  4. 选择每个工具可以做什么每项服务的页面都列出了它的工具,每个工具都有一个包含三种设置的菜单。“始终允许”会不经询问直接运行调用。“询问”会先把确认放到你面前。“拒绝”会让代理完全看不到该工具,对它的调用会被拒绝,并附有说明已被 Emerald Tools 阻止的消息。
  5. 向代理提出请求用平常的话提出请求。调用设为“询问”的工具时,“允许此操作?”面板会写明代理、工具以及它发送的参数。“允许”会运行它;“不允许”或等倒计时结束,则会改为向代理发送拒绝。有两个工具会用自己的窗口代替这个面板:完成提醒事项时会显示代理想要完成的每一个提醒事项,准备邮件时会打开一个只有你能从中发送的撰写窗口。
    代码编辑器前方一个标题为 Allow this action? 的 Emerald Tools 面板,写着 claude-code (via Emerald Tools MCP) 请求使用 reminders_append_note,显示包含提醒事项 ID 和文本 Sample text 的参数,倒计时显示 29 秒后自动取消,以及 Don't Allow 和 Allow 按钮。图片显示的是英文界面。

各项服务及其指南

每项服务都有自己的工具,并在“工具组”下有自己的页面。上面的步骤是共通的;代理在每项服务中能做什么,分别另行说明。

  • 提醒事项 — 列出、读取、创建、更新和完成提醒事项,以及追加备注。代理不能删除提醒事项。请参阅让 AI 代理管理 Apple 提醒事项。
  • 邮件 — 搜索和阅读你的 IMAP 邮件账户,并在撰写窗口中打开新邮件或回复,由你检查后发送。代理不能发送。请参阅让 AI 代理搜索邮件并准备草稿。
  • 系统指标 — 读取应用记录的系统指标历史。只有一个工具 metrics_query_range,在下文说明。

三层控制

权限在调用到达你的数据之前,由你 Mac 上的 Emerald Tools 决定。

服务器开关决定是否有任何东西能够连接。在你打开之前,它保持关闭。

服务开关 — “工具组”下的“提醒事项”“系统指标”“邮件” — 会一次性打开或关闭一整类工具。被关闭的服务会向代理报告为已被 Emerald Tools 阻止。

单个工具的设置是细节所在。“始终允许”适用于你放心让它运行的工具;“询问”每次都会把确认放到你面前;“拒绝”会把该工具从代理看到的列表中移除。

你的 MCP 客户端可能还会在此之上加入它自己的权限提示。两者不会互相取代 — 一次调用必须同时通过两者。

确认面板显示什么

面板的标题是「允许此操作?」,并写明三件事:客户端(按它连接时自我介绍的名称)、工具,以及它发送的完整参数。下方的倒计时显示距离自动取消还剩多长时间。允许会运行调用。不允许或倒计时归零,则会向代理发送一个它可以读取并向你解释的拒绝。

有两个工具在设为“询问”时会用自己的窗口代替这个面板。完成提醒事项时会显示一个面板,列出代理想要完成的每一个提醒事项。准备邮件时会打开一个填好代理建议内容的撰写窗口;在你于该窗口中点击“发送”之前,什么都不会发出。

连接是如何工作的

你的 AI 客户端与 Emerald Tools 之间的连接永远不会离开你的 Mac。

  • 服务器位于应用内部,在应用自己的容器中监听一个本地套接字。它不打开任何网络端口。
  • 连接器是随应用附带的一个小程序。 你的 MCP 客户端会像启动任何 stdio 服务器一样启动它,它在客户端和正在运行的应用之间传递消息,而不读取其内容。
  • 应用必须正在运行。 如果没有运行,连接器会告诉客户端它无法连接到 Emerald Tools。
  • 每项服务以各自的方式访问数据。 “提醒事项”通过 macOS 自己的提醒事项权限访问,系统会在代理第一次使用时请求该权限。“邮件”从你的 Mac 通过加密连接访问你所添加账户的邮件服务器。“系统指标”读取应用保存在你 Mac 上的历史。

系统指标工具

工具 作用 默认
metrics_query_range 读取应用记录的系统指标历史,针对一项指标和一个时间范围 始终允许

指标包括 CPU、内存、磁盘、GPU、电池、网络接收和发送、存储读取和写入,以及 Swap。细节程度随范围的长短而定:一小时以内为单个采样,一天以内为分钟平均值,30 天以内为小时平均值,更长则为天平均值。应用未运行的时段会作为空缺返回。

规格和限制

  • 服务: 提醒事项、邮件和系统指标,每项服务都可以整体打开或关闭。
  • 权限: 每个工具可设为始终允许、询问或拒绝;读取默认为始终允许,更改或准备内容默认为询问。
  • 确认超时: 默认 30 秒,可在“设置”中调整为 5 到 600 秒。
  • 传输: 客户端与随附连接器之间使用 stdio,连接器与应用之间使用本地套接字。不使用网络端口。
  • 客户端: 任何支持 stdio 服务器、运行在同一台 Mac 上的 MCP 客户端。
  • 系统要求: macOS 14.0 (Sonoma) 或更高版本,Emerald Tools 1.2 或更高版本;邮件需要 Emerald Tools 1.3 或更高版本。

Emerald Tools 是一款独立应用。 它与 Anthropic、Apple 或任何邮件服务提供商都没有关联,也未获得其认可或赞助。MCP 服务器是让你已在使用的 AI 客户端按照你设定的规则访问你的数据的一种方式;它本身不提供 AI 模型。

常见问题

哪些 MCP 客户端可以使用它?

任何能够运行 stdio 服务器的 MCP 客户端。应用为 Claude Code 显示现成的 claude mcp add 命令行,为其他所有客户端显示一个 JSON 条目;这个 JSON 放在哪里取决于客户端,请在客户端自己的文档中查找其配置文件的位置。连接器不会打开网络端口,所以客户端必须与 Emerald Tools 运行在同一台 Mac 上。

每次操作前都会询问吗?

只有你设为“询问”的工具才会。初始状态下,只读取的工具设为“始终允许”,会更改内容或为你准备内容的工具 — 创建、更新或完成提醒事项、追加备注、打开撰写窗口 — 设为“询问”。其中任何一个你都可以在该服务的页面上更改。

如果我不回答确认面板会怎样?

它会在 30 秒后自动取消,代理会被告知该操作未获批准。等待时间可以在“设置”的“MCP 服务器”标签页中设为 5 到 600 秒之间的任意值。

我的 MCP 客户端也会请求权限。以哪一个为准?

两者都适用。只有当你的客户端和 Emerald Tools 都允许时,调用才会不经提示直接运行。当拒绝的是 Emerald Tools 时 — 工具设为“拒绝”,或服务被关闭 — 代理会被明确告知是 Emerald Tools 阻止了它,因此这种拒绝永远不会被误认为是客户端中的设置。

打开或关闭某项服务后需要重新连接吗?

不需要。你关闭的服务会从代理能看到的工具中消失,你打开的服务会出现,无需重新启动客户端。关闭 Emerald Tools MCP 开关本身则会断开所有已连接的客户端。

为什么代理无法连接到 Emerald Tools?

请按顺序检查三件事。Emerald Tools 应用必须正在运行,并且“MCP 服务器”页面上的 Emerald Tools MCP 开关必须打开。你注册的连接器路径必须与应用当前的位置一致 — 如果你移动了应用或更改了它的名称,请重新拷贝命令并重新注册。最后,客户端必须已经读取了注册信息:对于 Claude Code,应用给你的命令行会为所有文件夹注册,而不带该选项的普通 claude mcp add 只适用于你运行它的那个文件夹。

会向开发者发送任何内容吗?

不会。服务器是你 Mac 上应用的一部分,只响应你连接的客户端。Emerald Tools 不会把你的提醒事项、邮件或指标发送给开发者。打开“邮件”后,应用会像任何邮件应用一样,连接你所添加账户的邮件服务器。你的 AI 客户端如何处理这些响应(包括把它们传给它使用的模型)取决于该客户端及其提供商,所以那一部分适用的是它们的条款。

系统指标工具可以读取什么?

Emerald Tools 在你的 Mac 上记录的系统指标历史:CPU、内存、磁盘、GPU、电池、网络接收和发送、存储读取和写入,以及 Swap。代理指定一项指标和一个时间范围,细节程度随范围的长短而定 — 一小时以内为单个采样,一天以内为分钟平均值,30 天以内为小时平均值,更长则为天平均值。应用未运行的时段会作为空缺返回,而不会返回编造的数值。

需要什么?

一台运行 macOS 14.0 (Sonoma) 或更高版本的 Mac、Emerald Tools 1.2 或更高版本(邮件需要 1.3 或更高版本),以及同一台 Mac 上的 MCP 客户端。Emerald Tools 是一款提供 14 天免费试用的订阅制应用;App Store 页面会显示你所在地区的当前条款。

获取 macOS 版 Emerald Tools

MCP 服务器是 Emerald Tools 的一部分,此外还有多显示器动态壁纸、系统监控小组件、上传到 Google Drive 的屏幕截图、网页媒体收集器,以及 WebP 转 MP4 转换器。它常驻菜单栏,不占用程序坞。

在 App Store 下载