这个项目能做什么

iMCP 是一款 macOS 应用(需 macOS 15.3+),它运行一个本地 MCP 服务器,允许 Claude Desktop、Claude Code、Cursor 和 Amp 等 AI 客户端访问你 Mac 上的个人数据和系统服务。该应用可通过直接下载或 Homebrew 获取。 该应用在九个服务领域提供工具: - 日历:查看和管理事件,创建带有重复、提醒和可用性设置的新事件。 - 通讯录:查找你自己的联系信息,并按姓名、电话或电子邮件搜索联系人。 - 位置:检索当前位置数据,并在地址和坐标之间进行转换。 - 地图:搜索地点、获取路线、查找兴趣点、估算行程时间并生成静态地图图像。 - 信息:在可自定义的日期范围内访问与特定参与者的 iMessage 历史记录。 - 电话:查看从 iPhone 同步的通话记录,按参与者/日期/类型筛选,并在系统确认后发起通话。 - 提醒事项:查看和创建带有截止日期、优先级和提醒的提醒事项,跨列表管理。 - 快捷指令:列出并运行 macOS 快捷指令,可附带可选文本输入。 - 天气:检索任何位置的当前天气状况,包括温度、风速和天气情况。 每个服务都可以从菜单栏单独开启或关闭,并由 macOS 标准权限对话框控制访问。该项目声明不会收集或存储用户数据,但连接的客户端可能会在工具调用过程中将数据传输到设备外。 在技术上,该应用捆绑了一个 CLI 可执行文件(imcp-server),通过 Bonjour 在本地网络上与 GUI 应用通信。CLI 处理基于 stdio 的 MCP 传输,将请求转发给与 macOS 框架交互的应用。对于 iMessage 访问,应用在用户授予文件夹访问权限后读取 ~/Library/Messages/chat.db(包括其 WAL 日志)中的 SQLite 数据库。通话记录同样从 iPhone 同步的 SQLite 数据库中读取。工具结果以 JSON-LD 文档形式返回,使用 Schema.org 词汇表。 该项目还制作了官方的 MCP Swift SDK、用于读取 iMessage 数据库(包括解码 Apple 的 typedstream 格式)的 Madrid 包,以及用于结构化数据表示的 Ontology 包。采用 MIT 许可证。