I MCP

iMCP是一款macOS应用程序，用于将您的数字生活与人工智能连接起来。 它与 克劳德桌面版 以及a 不断增长的客户名单 支持 模型上下文协议（MCP）.

能力

Calendar View and manage calendar events, including creating new events with customizable settings like recurrence, alarms, and availability status.

Contacts Access contact information about yourself and search your contacts by name, phone number, or email address.

Location Access current location data and convert between addresses and geographic coordinates.

Maps Provides location services including place search, directions, points of interest lookup, travel time estimation, and static map image generation.

Messages Access message history with specific participants within customizable date ranges.

Reminders View and create reminders with customizable due dates, priorities, and alerts across different reminder lists.

Weather Access current weather conditions including temperature, wind speed, and weather conditions for any location.

入门指南

下载并打开应用程序

第一， 下载iMCP应用程序 （需要macOS 15.3或更高版本）。

或者，如果你有 家酿 安装， 您可以运行以下命令：

brew install --cask mattt/tap/iMCP

当你打开应用程序时， 你会看到一个

菜单栏中的图标。

点击此图标显示iMCP菜单， 其显示所有可用服务。 最初所有服务将以灰色显示， 表明它们处于非活动状态。

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

激活服务

要激活服务，请单击其图标。 系统将提示您一个权限对话框。 例如，激活日历访问时，您将看到一个对话框，询问 "iMCP" Would Like Full Access to Your Calendar. 点击 允许完全访问 继续。

\[！重要\] iMCP 不 收集或存储您的任何数据。 像Claude Desktop这样的客户 _做_ 发送 作为工具调用的一部分，将您的数据从设备上移除。

一旦激活， 每个服务图标都从灰色变成了独特的颜色-- 红色表示日历，绿色表示消息，蓝色表示位置，以此类推。

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

连接到克劳德桌面

如果您没有安装Claude Desktop， 你可以 在这里下载.

打开克劳德桌面并转到“设置(⌘,)". 点击“设置”窗格侧边栏中的“开发人员”， 然后单击“编辑配置”。 这将在以下位置创建一个配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json.

为了将iMCP连接到克劳德桌面， 点击 \>“配置克劳德桌面”。

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

You can also configure Claude Desktop manually

点击 \>“将服务器命令复制到剪贴板”。 然后打开 claude_desktop_config.json 在你的编辑器中 并输入以下内容：

{
  "mcpServers": {
    "iMCP": {
      "command": "{paste iMCP server command}"
    }
  }
}

从Claude Desktop调用iMCP工具

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

在批准连接之后， 你现在应该看到了🔨12在聊天框的右下角。 点击此处查看克劳德可用的所有工具列表 iMCP。

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

“我所在的地方天气怎么样？”

Claude将使用适当的工具来检索此信息， 为您提供准确、个性化的回复 无需在对话过程中手动共享此数据。

连接到 克劳德代码

要在安装应用程序后全局添加iMCP：

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

Or import from Claude Desktop

如果您已经配置了Claude Desktop，则可以导入其MCP服务器：

claude mcp add-from-claude-desktop

连接到 光标

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

连接到 安培

要在全球范围内添加iMCP（在所有项目中都可用）：

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

\[！注意\] 当客户端首次连接时，iMCP将显示一个批准对话框。 单击“允许”并选中“始终信任此客户端”以避免重复提示。

技术细节

应用程序和CLI

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

• iMCP.app 提供用于配置服务的UI，最重要的是--

与macOS系统权限交互的一种方式， 以便它可以访问联系人、日历和其他信息。

• imcp-server 提供了一个MCP服务器

使用标准输入/输出进行通信 (stdio传输).

应用程序和CLI在本地网络上相互通信 使用 你好 用于自动发现。 两者都用“\_mcp.\_tcp”类型和“local”域来宣传服务。 来自MCP客户端的请求由CLI从以下位置读取 stdin 并转发到应用程序； CLI接收来自应用程序的响应，并将其写入 stdout. 看 StdioProxy 了解实施细节。

对于这个项目，我们创建了 官方Swift SDK 用于模型上下文协议服务器和客户端。 该应用程序使用此包来处理来自MCP客户端的代理请求。

iMessage数据库访问

Apple不提供用于访问您的消息的公共API。 但是，macOS上的Messages应用程序将数据存储在SQLite数据库中，该数据库位于 ~/Library/Messages/chat.db.

iMCP在中运行 应用沙箱, 这限制了其对用户数据和系统资源的访问。 当您启动“消息”服务时， 系统将提示您打开 chat.db 通过标准文件选择器创建文件。 当你这样做时，macOS会将该文件添加到应用程序的沙盒中。 NSOpenPanel 就是这样的魔法。

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

对于这个项目，我们创建了 马德里: 一个用于读取iMessage数据库的Swift包。 它包括一个Swift实现，用于解码苹果的 typedstream 格式， 改编自Christopher Sardegna的 imemessage出口商 项目 和 关于逆向工程的博客文章 typedstream.

JSON-LD用于工具结果

iMCP提供的工具返回的结果为 JSON-LD 文件。 例如， 这 fetchContacts 工具使用 联系人框架, 代表个人和组织 CNContact 类型。 以下是将该类型的对象编码为JSON-LD的方式：

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

Schema.org 提供标准词汇表 人、邮政地址、事件以及我们想要表示的许多其他对象。 JSON-LD是一种方便的编码格式 人类、人工智能和传统软件。

对于这个项目，我们创建了 本体论: 一个用于处理结构化数据的Swift包。 它包括来自Apple框架的类型的便利初始化器， 例如iMCP工具返回的那些。

调试

使用MCP检查器

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

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

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

   # Download and run inspector package on imcp-server
   npx @modelcontextprotocol/inspector [paste-copied-command]

   # Open inspector web app running locally
   open http://127.0.0.1:6274

Inspector允许您查看客户端和iMCP服务器之间的所有请求和响应， 这有助于理解协议是如何工作的。

使用伴侣

同伴 是用于测试和调试MCP服务器的实用程序 （需要macOS 15或更高版本）。 它为您提供了一种简单的浏览和交互方式 服务器的提示、资源和工具。 以下是如何将其连接到iMCP：

1. 点击 >“将服务器命令复制到剪贴板”
2. 下载 并打开Companion应用程序
3. 点击 + 工具栏中的按钮，用于添加MCP服务器
4. 填写表格：

- 输入“iMCP”作为名称 - 选择“STDIO”作为传输方式 - 粘贴复制的iMCP服务器命令 - 点击“添加服务器”

致谢

• 贾斯汀·斯珀尔·萨默斯

(@jspahrsummers), 大卫·索里亚·帕拉 (@dsp蚂蚁)，以及 阿什温·巴特 (@阿什温蚂蚁) 感谢他们在MCP上的工作。

• 克里斯托弗·萨德加纳

(@试剂X) 对于逆向工程 typedstream 格式 由Messages应用程序使用。

许可证

该项目在MIT许可下可用。 有关更多信息，请参阅LICENSE文件。

法律

iMessage®是苹果股份有限公司的注册商标。 本项目不隶属于、认可或赞助苹果股份有限公司。