Apple Native Tools

🚀 蘋果 MCP 工具

蘋果 MCP 工具是一個專為 MCP 協議 打造的蘋果原生工具集合，能幫助用戶在蘋果設備上實現多樣化的自動化操作，提升工作和生活效率。

關於如何設置和演示的分步視頻，請參閱：https://x.com/DhravyaShah/status/1892694077679763671

{
  "mcpServers": {
    "apple-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "apple-mcp@latest"]
    }
}

🚀 快速開始

📦 安裝指南

自動安裝

通過 Smithery 自動安裝 Apple MCP for Claude Desktop：

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client claude

以及用於 cursor：

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client cursor

手動安裝

如果不想使用 Smithery，可以按照以下步驟手動安裝：

1. 克隆倉庫：

   git clone https://github.com/Dhravya/apple-mcp.git
   cd apple-mcp
   

2. 安裝依賴項：

   npm install
   

3. 啟動服務：

   node index.js
   

✨ 主要特性

• 消息：

  • 使用 Apple Messages 應用發送消息
  • 朗讀消息內容

• 筆記：

  • 列出所有筆記
  • 在 Apple Notes 應用中搜索並閱讀筆記

• 聯繫人：

  • 搜索聯繫人以發送消息

• 郵件：

  • 使用多個收件人（to, cc, bcc）和文件附件發送郵件
  • 使用自定義查詢、郵箱選擇和結果限制來搜索郵件
  • 設置未來時間的計劃郵件
  • 列出並管理已安排的郵件
  • 檢查全局或按郵箱的未讀郵件數量

• 提醒事項：

  • 列出所有提醒事項和提醒列表
  • 搜索包含特定文本的提醒事項
  • 創建新的提醒事項，可選截止日期和備註
  • 在 Reminders 應用中打開以查看具體提醒事項

• 日曆：

  • 使用自定義日期範圍搜索日曆事件
  • 列出即將進行的活動
  • 創建新日曆事件，包含標題、地點和備註等詳細信息
  • 在 Calendar 應用中打開特定的日曆事件

• 網頁搜索：

  • 使用 DuckDuckGo 搜索網絡
  • 獲取並處理來自搜索結果的內容

• 地圖：

  • 搜索位置和地址
  • 將位置保存為 favorites
  • 獲取兩點之間的路線指引
  • 在地圖上放置路標
  • 創建、列出指南
  • 將地點添加到指南中

• 待辦：在 Apple Photos 應用中搜索包含特定文本的提醒事項

• 待辦：在 Apple Photos 應用中搜索位置和照片

💻 使用示例

基礎用法

安裝完成後，您可以通過配置 MCP 代理來使用這些功能。具體步驟如下：

1. 配置 MCP 代理以指向您的 Apple 設備。
2. 在您的 AI 模型中設置相應的 API 調用。

例如，在 Claude 中，您可以這樣配置：

{
  "providing": {
    "apple-mcp": {
      "url": "http://localhost:3000"
    }
  }
}

然後，您就可以在對話中使用以下功能：

• /apple/mcp/send-message：發送消息。
• /apple/mcp/read-message：朗讀消息。
• /apple/mcp/search-notes：搜索筆記。

高級用法

發送一條消息給 John：

/apple/mcp/send-message to=John message="Hello, how are you?"

搜索包含“會議”的筆記：

/apple/mcp/search-notes query="會議"

設置一個提醒事項：

/apple/mcp/create-reminder title="開會" date="2023-10-05 14:00"

⚠️ 重要提示

• 確保您的 Apple 設備已正確配置並連接到網絡。
• 安裝和使用過程中請遵守相關法律法規，尊重用戶隱私。

希望這些工具能為您的自動化流程增添便利！