Apple MCP Server

🚀 Apple MCP 工具

這是一個專為蘋果設備打造的工具集合，基於 MCP 協議 開發，能為蘋果設備用戶提供豐富的功能支持。

以下是關於如何設置和演示的分步視頻：查看視頻

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

🚀 快速開始

快速安裝

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

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

若要為 Cursor 安裝，可使用以下命令：

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

✨ 主要特性

• 消息：
  • 可使用 Apple Messages 應用發送消息。
  • 支持播報消息內容。
• 筆記：
  • 能列出所有筆記。
  • 可在 Apple Notes 應用中搜索和閱讀筆記。
• 聯繫人：
  • 可搜索聯繫人以獲取發送消息的信息。
• 郵件：
  • 支持發送帶有多個收件人（包括抄送和密送）的電子郵件。
  • 可使用自定義查詢、郵箱選擇和結果限制來搜索郵件。
  • 能安排未來時間送達的郵件。
  • 可列出並管理已安排的郵件。
  • 能檢查全局或按郵箱的未讀郵件數量。
• 提醒事項：
  • 可列出所有提醒事項及提醒列表。
  • 能根據文本搜索提醒事項。
  • 可創建新的提醒事項，可選設置截止日期和備註。
  • 可在 Reminders 應用中打開以查看特定提醒事項。
• 日曆：
  • 可使用自定義日期範圍搜索日曆事件。
  • 能列出即將進行的活動。
  • 可創建新日曆事件，包含標題、地點和備註等詳細信息。
  • 可在 Calendar 應用中打開特定的日曆事件。
• 網絡搜索：
  • 可在 Google 等平臺執行網頁搜索。
  • 能獲取搜索結果列表。
  • 可打開指定的搜索結果鏈接。
• 地圖：
  • 可搜索地理位置並獲取經緯度座標。
  • 能查看位置信息。

📦 安裝指南

快速安裝

通過以下命令可在 macOS 或 Linux 上快速安裝工具：

sudo apt-get update && sudo apt-get install -y curl unzip
curl -L "https://github.com/yourusername/apple-mcp/raw/main/install.sh" | bash

手動安裝

1. 安裝 Node.js 和 npm：

# 使用 nvm 安裝 Node.js 14.x 或更高版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install --lts

2. 克隆倉庫並安裝依賴：

git clone https://github.com/yourusername/apple-mcp.git
cd apple-mcp
npm install

3. 啟動服務：

node index.js

💻 使用示例

基礎用法

發送郵件

{
  "command": "send_email",
  "args": {
    "to": "recipient@example.com",
    "subject": "Test Email",
    "body": "This is a test email from the MCP tool."
  }
}

搜索地理位置

{
  "command": "search_location",
  "args": {
    "query": "New York City"
  }
}

高級用法

獲取天氣信息

{ command: 'get_weather', args: { location: 'London' } }

搜索附近餐館

{ command: 'search_restaurants', args: { location: 'Tokyo' } }

本地開發

1. 克隆倉庫並安裝依賴：

git clone https://github.com/yourusername/apple-mcp.git
cd apple-mcp
npm install

2. 啟動開發服務器：

npm run dev

3. 測試功能：

• 訪問 http://localhost:3000 查看文檔和測試界面。
• 使用提供的 API 接口進行功能測試。

更多詳細信息請參考項目文檔或倉庫中的 README 文件。

📚 詳細文檔

參考資料

• MCP 協議官方文檔
• Smithery 平臺
• Node.js 官方網站
• NPM 官方倉庫