综合介绍
iMCP 是一款专为 macOS 用户设计的应用程序,通过 Model Context Protocol(MCP)将你的日常数据(如消息、联系人、日历等)与 AI 工具无缝连接。它由 loopwork-ai 团队开发,支持与 Claude Desktop 等客户端协作,让用户可以直接通过 AI 获取个性化信息,比如查询当前位置天气或管理日程。iMCP 不存储用户数据,依赖 macOS 的沙盒权限确保隐私安全。目前,它需要 macOS 15.3 或更高版本,适合希望将本地数据与 AI 结合使用的技术爱好者或开发者。
功能列表
- 日历管理:查看和创建日历事件,支持设置重复规则、提醒和忙闲状态。
- 联系人查询:访问个人信息或按姓名、电话、邮箱搜索联系人。
- 位置服务:获取当前位置数据,并转换地址与地理坐标。
- 消息历史:检索与特定联系人的消息记录,可自定义时间范围。
- 提醒事项:查看和添加提醒,支持设置截止日期、优先级和通知。
- 天气查询:提供任意地点的实时天气信息,包括温度、风速等。
- JSON-LD 输出:工具结果以标准化的 JSON-LD 格式返回,便于 AI 处理。
使用帮助
安装流程
- 下载 iMCP
访问 GitHub 页面,下载最新版本的 iMCP 应用程序。确保你的 macOS 系统版本在 15.3 或以上。下载后,将文件拖到“应用程序”文件夹中。 - 首次打开
双击 iMCP.app 启动程序。初次运行时,系统可能提示“无法打开,因为开发者未验证”。右键点击文件,选择“打开”,然后在弹窗中确认“打开”以绕过限制。启动后,你会在菜单栏看到 iMCP 的图标。 - 连接 Claude Desktop
- 如果没有 Claude Desktop,先从其官网下载并安装。
- 打开 Claude Desktop,按
⌘ + ,
进入“设置”,选择“Developer”选项卡,点击“Edit Config”。 - 在 iMCP 界面,点击“Configure Claude Desktop”,程序会自动将
imcp-server
的配置写入~/Library/Application Support/Claude/claude_desktop_config.json
文件。 - 或者手动配置:点击“Copy server command to clipboard”,将命令粘贴到配置文件中,格式如下:
{ "mcpServers": { "iMCP": { "command": "{粘贴的命令}" } } }
- 保存文件后,关闭并重启 Claude Desktop。系统会弹出连接确认窗口,可能出现两次,均点击“Approve”。
功能操作流程
激活服务
- 点击菜单栏中的 iMCP 图标,弹出服务列表。初始状态下,所有服务图标为灰色,表示未激活。
- 点击某个服务图标(如日历),macOS 会弹出权限请求窗口,例如“‘iMCP’想完全访问您的日历”。选择“允许完全访问”。
- 激活后,图标变为彩色(日历为红色,消息为绿色等)。重复此步骤激活其他服务。
- 特别说明:激活“消息”服务时,需通过文件选择器手动打开
~/Library/Messages/chat.db
文件,授权 iMCP 访问。
使用日历管理
- 在 Claude Desktop 的聊天框输入:“今天有哪些日程?”
- Claude 会调用 iMCP 的日历工具,返回当天事件列表。你可以继续输入:“添加一个明天下午 3 点的会议,提醒我提前 15 分钟。”
- iMCP 会创建新事件并设置提醒,完成后返回确认信息。
查询联系人
- 输入:“我的联系人里谁的电话是 123-456-7890?”
- iMCP 会搜索并返回匹配的联系人姓名及其他信息。支持按姓名或邮箱查询,如:“查找 John Doe 的邮箱。”
获取位置和天气
- 输入:“我现在在哪?那里的天气如何?”
- iMCP 先调用位置服务获取坐标,再通过天气工具返回当前温度、风速等数据。例如:“你在旧金山,天气晴朗,温度 20°C。”
查看消息历史
- 输入:“我和 Alice 上周说了什么?”
- iMCP 会检索
chat.db
中与 Alice 的对话,按指定时间范围返回消息内容。结果以 JSON-LD 格式呈现,清晰易读。
设置提醒
- 输入:“提醒我明天上午 9 点买牛奶,优先级高。”
- iMCP 创建提醒事项,包含截止日期和优先级设置,并在 Claude 中确认:“提醒已添加。”
操作小贴士
- 查看可用工具:重启 Claude Desktop 后,聊天框右下角显示“🔨12”,点击可查看 iMCP 提供的工具列表。
- 隐私控制:每次激活服务都需要手动授权,未激活的服务无法访问数据。
- 技术细节:iMCP 通过 Bonjour 在本地网络自动发现服务,
imcp-server
使用标准输入输出与客户端通信。
通过以上步骤,你可以轻松上手 iMCP,将 macOS 数据与 AI 结合,提升日常效率。