iMCP 是一款 macOS 应用程序，可将您的数字生活与人工智能连接起来。 它可与 Claude Desktop 以及支持 模型上下文协议 (MCP) 的 不断增长的客户端列表 配合使用。

功能

	日历	查看和管理日历事件，包括创建具有自定义设置的新事件，例如重复、提醒和可用性状态。
	通讯录	访问您自己的联系人信息，并可通过姓名、电话号码或电子邮件地址搜索联系人。
	位置	访问当前位置数据，并在地址和地理坐标之间进行转换。
	地图	提供位置服务，包括地点搜索、路线规划、兴趣点查询、行程时间估算以及静态地图图像生成。
	消息	在自定义日期范围内访问与特定参与者的消息记录。
	提醒	查看和创建具有自定义截止日期、优先级和警报的提醒，并可在不同的提醒列表中进行管理。
	天气	访问当前天气状况，包括温度、风速以及任何地点的天气情况。

开始使用

下载并打开应用

首先，请下载 iMCP 应用 （需要 macOS 15.3 或更高版本）。

或者，如果您已安装 Homebrew，可以运行以下命令：

brew install --cask mattt/tap/iMCP

打开应用后，您会在菜单栏中看到一个 图标。

单击此图标即可显示 iMCP 菜单，其中列出了所有可用的服务。最初，所有服务将以灰色显示，表示它们处于未启用状态。

顶部的蓝色切换开关表示 MCP 服务器正在运行， 并已准备好与兼容 MCP 的客户端建立连接。

激活服务

要激活某项服务，只需单击其图标。系统会弹出权限请求对话框。例如，当您激活“日历”访问权限时，会出现一个对话框，提示“iMCP 想要完全访问您的日历”。点击允许完全访问继续。

[!重要] iMCP 不会收集或存储您的任何数据。 像 Claude Desktop 这样的客户端则会将您的数据发送到设备之外， 作为工具调用的一部分。

一旦激活，每个服务的图标就会从灰色变为各自的特色颜色——日历为红色，消息为绿色，位置为蓝色，以此类推。

对您希望启用的所有功能重复此过程。这些权限遵循 Apple 的标准安全模型， 使您可以完全控制 iMCP 可以访问哪些信息。

连接到 Claude Desktop

如果您尚未安装 Claude Desktop，可以在此处下载。

打开 Claude Desktop，转到“设置… (⌘,)”。 在设置面板的侧边栏中，单击“开发者”，然后单击“编辑配置”。 这将创建一个配置文件，位于 ~/Library/Application Support/Claude/claude_desktop_config.json。

要将 iMCP 连接到 Claude Desktop， 请点击 > “配置 Claude Desktop”。

这将添加或更新 MCP 服务器配置，以使用应用程序中捆绑的 imcp-server 可执行文件。文件中的其他 MCP 服务器配置将被保留。

{
  "mcpServers": {
    "iMCP": {
      "command": "{粘贴 iMCP 服务器命令}"
    }
  }
}

从 Claude Desktop 调用 iMCP 工具

退出并重新打开 Claude Desktop 应用程序。系统将提示您批准连接。

批准连接后，您现在应该会在聊天框的右下角看到 🔨12。 点击它即可查看由 iMCP 提供给 Claude 的所有可用工具列表。

现在，您可以向 Claude 提出需要访问您个人数据的问题，例如：

“我现在所在的地方天气如何？”

Claude 将使用相应的工具来获取这些信息， 为您提供准确且个性化的回复， 而无需您在对话过程中手动分享这些数据。

连接到 Claude Code

在安装应用后，要将 iMCP 全局添加：

claude mcp add --scope user iMCP -- /Applications/iMCP.app/Contents/MacOS/imcp-server

claude mcp add-from-claude-desktop

连接到 Cursor

打开此深度链接以自动安装 iMCP 服务器：

连接到 Amp

要全局添加 iMCP（在所有项目中可用）：

amp mcp add iMCP -- /Applications/iMCP.app/Contents/MacOS/imcp-server

[!NOTE] 当客户端首次连接时，iMCP 会显示一个批准对话框。 点击“允许”并勾选“始终信任此客户端”，以避免重复提示。

技术细节

应用程序与命令行工具

iMCP 是一款 macOS 应用程序，捆绑了一个命令行可执行文件 imcp-server。

• iMCP.app 提供用于配置服务的用户界面，最重要的是， 它提供了一种与 macOS 系统权限交互的方式， 以便访问通讯录、日历等信息。
• imcp-server 提供一个 MCP 服务器，使用标准输入输出进行通信 (stdio transport)。

应用程序和命令行工具通过本地网络相互通信， 使用 Bonjour 进行自动发现。 两者都以 _mcp._tcp 类型和服务域为 local 来发布服务。 来自 MCP 客户端的请求由命令行工具从 stdin 读取， 并转发给应用程序； 应用程序的响应则由命令行工具接收，并写入到 stdout。 有关实现细节，请参阅 StdioProxy。

为此项目，我们创建了后来成为 官方 Swift SDK 用于 Model Context Protocol 服务器和客户端的软件开发包。 该应用程序使用此软件包来处理来自 MCP 客户端的代理请求。

iMessage 数据库访问

Apple 并未提供公开的 API 来访问你的消息。 然而，macOS 上的 Messages 应用程序将数据存储在一个 SQLite 数据库中， 位于 ~/Library/Messages/chat.db。

iMCP 在 App Sandbox 中运行， 这限制了它对用户数据和系统资源的访问。 当你尝试启用 Messages 服务时， 系统会提示你通过标准文件选择器打开 chat.db 文件。 当你这样做时，macOS 会将该文件添加到应用程序的沙盒中。 NSOpenPanel 就是这样一种神奇的功能。

不过，打开 iMessage 数据库只是成功的一半。 在过去几年里， Apple 已经不再以纯文本形式存储消息， 而是转向了一种专有的 typedstream 格式。

为此项目，我们创建了 Madrid： 一个用于读取你的 iMessage 数据库的 Swift 软件包。 它包含一个 Swift 实现，用于解码 Apple 的 typedstream 格式， 改编自 Christopher Sardegna 的 imessage-exporter 项目 以及关于逆向工程 typedstream 的 博客文章。

JSON-LD 用于工具结果

iMCP 提供的工具会以 JSON-LD 文档的形式返回结果。 例如， fetchContacts 工具使用了 Contacts framework， 该框架用 CNContact 类型来表示个人和组织。 以下是该类型对象如何编码为 JSON-LD：

{
  "@context": "https://schema.org",
  "@type": "Person",
  "name": "Mattt",
  "url": "https://mat.tt"
}

Schema.org 提供了用于表示人物、邮政地址、事件等对象的标准词汇表。 而 JSON-LD 则是一种方便的编码格式， 适用于人类、人工智能以及传统软件。

为此项目，我们创建了 Ontology： 一个用于处理结构化数据的 Swift 软件包。 它包括来自 Apple 框架类型的便捷初始化器， 例如 iMCP 工具所返回的对象。

调试

使用 MCP 检查器

为了调试 iMCP 与客户端之间的交互， 你可以使用 检查器工具 （需要 Node.js）：

1. 点击 > “复制服务器命令到剪贴板”

2. 打开终端并运行以下命令：

   # 下载并运行检查器包于 imcp-server
   npx @modelcontextprotocol/inspector [粘贴复制的命令]
   
   # 打开本地运行的检查器 Web 应用程序
   open http://127.0.0.1:6274
   

检查器可以让你查看客户端与 iMCP 服务器之间的所有请求和响应， 这对于理解协议的工作方式非常有帮助。

使用 Companion

Companion 是一款用于测试和调试 MCP 服务器的实用工具 （需要 macOS 15 或更高版本）。 它提供了一种简便的方式来浏览和与服务器的提示、资源和工具进行交互。 以下是将其连接到 iMCP 的方法：

1. 点击 > “复制服务器命令到剪贴板”
2. 下载 并打开 Companion 应用程序
3. 点击工具栏中的 + 按钮以添加 MCP 服务器
4. 填写表单：
   • 输入“iMCP”作为名称
   • 选择“STDIO”作为传输方式
   • 粘贴复制的 iMCP 服务器命令
   • 点击“添加服务器”

致谢

• Justin Spahr-Summers (@jspahrsummers), David Soria Parra (@dsp-ant), 和 Ashwin Bhat (@ashwin-ant) 感谢他们对 MCP 所做的工作。
• Christopher Sardegna (@ReagentX) 感谢他逆向工程了 Messages 应用程序使用的 typedstream 格式。

许可证

本项目采用 MIT 许可证。更多信息请参阅 LICENSE 文件。

法律声明

iMessage® 是苹果公司的注册商标。 本项目与苹果公司无任何关联，亦未获得其认可或赞助。

iMCP 快速上手指南

iMCP 是一款 macOS 应用程序，旨在通过 Model Context Protocol (MCP) 将您的数字生活（日历、联系人、位置、信息等）与 AI 连接。它允许 Claude Desktop、Cursor 等客户端安全地访问您的本地数据。

环境准备

• 操作系统：macOS 15.3 (Sequoia) 或更高版本。
• 前置依赖：
  • 已安装支持 MCP 的客户端（如 Claude Desktop、Cursor 或 Claude Code）。
  • （可选）Homebrew：用于便捷安装。

安装步骤

您可以选择以下任一方式安装 iMCP：

方式一：使用 Homebrew（推荐）

如果您已安装 Homebrew，在终端运行以下命令：

brew install --cask mattt/tap/iMCP

方式二：手动下载

访问 iMCP 官网下载页 下载应用安装包，双击安装并将应用移至“应用程序”文件夹。

基本使用

1. 启动与授权服务

1. 打开 iMCP 应用。您将在菜单栏看到一个图标。
2. 点击菜单栏图标，你会看到所有可用服务（日历、联系人、位置等）初始状态为灰色（未激活）。
3. 点击您需要使用的服务图标（例如"Calendar"）。
4. 系统会弹出权限请求对话框（例如 "iMCP" Would Like Full Access to Your Calendar），点击 Allow Full Access。
5. 重复此步骤以激活其他所需服务。激活后，图标将变为彩色。

注意：iMCP 本身不会收集或存储您的任何数据。数据仅在 AI 客户端调用工具时按需传输。

2. 连接 Claude Desktop

1. 确保已安装并打开 Claude Desktop。
2. 进入设置 (⌘ + ,) -> 侧边栏选择 Developer -> 点击 Edit Config。这将创建或打开配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json。
3. 回到 macOS 菜单栏，点击 iMCP 图标 -> 选择 Configure Claude Desktop。
   • 此操作会自动将 imcp-server 配置写入上述 JSON 文件中。
4. 重启 Claude Desktop。
5. 重启后，系统会提示您批准连接，点击 Allow。
6. 在聊天输入框右下角，您应该能看到一个 🔨 图标及数字（表示可用工具数量）。点击即可查看 iMCP 提供的工具列表。

测试示例： 在对话框中输入：

"How's the weather where I am?"

Claude 将调用 iMCP 的位置和天气工具，直接读取您的实时位置和天气信息并回答。

3. 连接其他客户端

连接 Cursor

点击以下链接自动安装 iMCP 服务器：

连接 Claude Code

在终端运行以下命令全局添加 iMCP：

claude mcp add --scope user iMCP -- /Applications/iMCP.app/Contents/MacOS/imcp-server

或者，如果您已配置好 Claude Desktop，可以直接导入配置：

claude mcp add-from-claude-desktop

连接 Amp

在终端运行：

amp mcp add iMCP -- /Applications/iMCP.app/Contents/MacOS/imcp-server

提示：当新客户端首次连接时，iMCP 会弹出批准对话框。勾选 "Always trust this client" 可避免后续重复提示。