🚀 Apple MCP - 增强版
本增强版的 Apple MCP 在原 supermemoryai/apple-mcp 仓库的基础上，增添了更多功能并进行了优化。原项目提供了一个全面的模型上下文协议服务器，用于苹果生态系统集成，使 AI 助手能够与苹果原生应用程序进行交互。
🚀 快速开始
本增强版的 Apple MCP 是在原项目基础上进行的功能拓展与优化，旨在为用户提供更强大、便捷的使用体验。你可以按照以下安装步骤进行操作，然后通过使用示例快速上手。
✨ 主要特性
智能联系人解析
- 在消息工具中自动将联系人姓名解析为电话号码。
- 无需在发消息前手动查找联系人。
- 智能解析电话号码，优先采用国际格式。
增强的笔记管理
- 基于优先级的搜索算法，优先匹配标题而非内容。
- 搜索结果类型的视觉指示（标题匹配与内容匹配）。
- 完全支持苹果笔记的富文本格式和结构。
- 高级笔记编辑功能，可保留格式。
改进的错误处理
- 增强验证和用户友好的错误消息。
- 全面的错误指导和故障排除。
- 高级调试和日志记录功能。
开发者体验改进
- 增强的 TypeScript 接口和类型验证。
- 改进的代码组织和可维护性。
- 全面的调试和开发工具。
💻 使用示例
基础用法
"给 John 发送一条消息，告知晚餐会晚点到"
"搜索包含 'AI 研究' 的笔记并显示结果"
"创建一个明天下午 2 点看牙医的提醒"
"显示下周的日历事件"
"查找最近的咖啡店并添加到收藏夹"
📦 安装指南
选项 1：Smithery 集成
npx -y install-mcp apple-mcp --client claude
对于 Cursor IDE 用户：
npx -y install-mcp apple-mcp --client cursor
选项 2：手动配置
brew install oven-sh/bun/bun
添加到你的 claude_desktop_config.json 文件中：
{
"mcpServers": {
"apple-mcp": {
"command": "bunx",
"args": ["--no-cache", "apple-mcp@latest"]
}
}
}
📚 详细文档
核心功能
消息
- 使用联系人姓名发送消息，自动解析电话号码。
- 访问消息历史记录和对话线程。
- 安排消息在未来发送。
- 增强的错误处理和验证。
笔记
- 基于优先级的高级搜索，对结果进行排序。
- 支持完整格式的富文本创建和编辑。
- 笔记组织和文件夹管理。
- 修改内容时保留格式。
联系人
- 全面的联系人搜索和检索。
- 电话号码和电子邮件地址管理。
- 消息操作所需的集成步骤。
邮件
- 支持附件、抄送和密送的电子邮件撰写。
- 高级电子邮件搜索和过滤。
- 安排电子邮件发送。
- 监控未读消息。
提醒
- 创建带有截止日期管理的任务。
- 高级提醒搜索和组织。
- 全面的提醒列表和管理。
- 直接访问和修改提醒。
日历
- 事件创建和管理。
- 高级日历搜索功能。
- 会议和约会安排。
- 直接访问日历事件。
地图
- 地点搜索和发现。
- 收藏地点管理。
- 路线规划和导航。
- 创建地点指南和管理标记。
🔧 技术细节
开发环境设置
git clone https://github.com/Ayaanisthebest/appleMCP.git
cd appleMCP
bun install
bun run index.ts
📄 许可证
本项目采用 MIT 许可证。有关完整的许可条款，请参阅 LICENSE 文件。
如需了解原项目的更多信息，请访问：https://mcp.supermemory.ai
致谢
原开发团队
本项目基于 supermemoryai/apple-mcp 开发团队奠定的基础构建：
- @Dhravya - 项目创始人兼主要开发者
- @jxnl - 核心架构和开发
- @calclavia - 开发和测试
- 整个 supermemory 团队提供的持续项目支持
增强开发
额外的功能和改进由 @Ayaanisthebest 开发。