金大哥 - applemcp MCP 详情

article

README

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

applemcp