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 開發。