Applemcp

🚀 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 开发。