MCP Server Apple Reminders

🚀 Apple 提醒 MCP 服務器

一個提供與 macOS 上的 Apple Reminders 原生集成的 MCP 服務器。藉助該服務器，用戶能通過標準化接口與提醒事項進行交互操作，提升任務管理效率。

English | 簡體中文

🚀 快速開始

此 MCP 服務器可與 macOS 上的 Apple Reminders 實現原生集成，用戶能通過標準化接口對提醒事項進行交互操作。

✨ 主要特性

• 列出所有提醒和提醒列表：用戶可查看所有提醒事項及其所屬的提醒列表。
• 創建新提醒：支持添加新提醒事項，可自定義標題、所屬列表、完成狀態、截止日期及備註信息。
• 標記提醒為完成或未完成：允許用戶更新特定提醒的完成狀態。
• 添加備註：能在提醒事項中添加額外信息備註，詳細記錄任務細節。
• 設置截止日期：為每個提醒事項設定具體截止時間，助力用戶管理任務優先級。
• macOS 原生集成：通過 Swift 實現本地集成，確保與 Apple 提醒服務高度兼容且性能優化。

📦 安裝指南

先決條件

1. 操作系統要求：macOS 系統（因項目依賴 Apple 提醒服務）。
2. Node.js 版本要求：Node.js 18 或更高版本，以支持最新特性及保障安全性。
3. 開發工具要求：Xcode 命令行工具，用於 Swift 代碼的編譯與構建。

安裝命令

npm install -g mcp-server-apple-reminders

📚 詳細文檔

配置指南

在 Cursor 中配置

1. 打開 Cursor 的設置界面。
2. 導航至插件管理部分。
3. 添加新的 MCP 服務器配置，指定服務器地址及端口。
4. 啟用 Apple 提醒集成選項。

在 ChatWise 中配置

1. 進入 ChatWise 的偏好設置菜單。
2. 選擇插件與擴展選項卡。
3. 添加一個新的 MCP 服務條目，填寫相應的服務器信息。
4. 啟動 Apple 提醒同步功能。

在 Claude Desktop 中配置

方法一：直接編輯配置文件

1. 打開終端應用。
2. 輸入以下命令訪問用戶目錄下的配置文件：

   cd ~/Library/Application\ Support/Claude/
   

3. 編輯 config.json 文件，添加以下內容：

   "mcpServers": {
     "appleRemindersServer": {
       "url": "http://localhost:8080",
       "enabled": true
     }
   }
   

方法二：通過圖形界面配置

1. 打開 Claude Desktop 的設置窗口。
2. 選擇插件管理標籤。
3. 點擊“添加新服務器”按鈕，輸入 Apple 提醒 MCP 服務器的相關信息。
4. 完成後保存設置。

開發步驟

1. 安裝依賴項：

   npm install
   

2. 構建 Swift 執行文件（用於 Apple 提醒本地集成）：

   npm run build:swift
   

3. 編譯 TypeScript 代碼：

   npm run build:ts
   

4. 啟動開發服務器：

   npm run start
   

項目結構

.
├── src/                   # 源代碼目錄
│   ├── index.ts           # 應用程序的主入口點
│   ├── server/            # MCP 服務器實現部分
│   ├── swift/             # 原生 Swift 集成代碼
│   │   ├── bin/           # 編譯後的 Swift 可執行文件
│   │   └── src/           # Swift 源代碼文件
│   ├── tools/             # CLI 工具與輔助腳本
│   ├── types/             # TypeScript 類型定義
│   └── utils/             # 輔助函數和工具模塊
├── dist/                  # 編譯後的輸出目錄（用於生產環境）
└── package.json           # 項目依賴管理文件

💻 使用示例

基礎用法

創建提醒

# 示例：創建一個新的購物提醒事項
{
  "command": "create_reminder",
  "title": "購買雜貨",
  "list": "家庭",
  "duedate": "2024-03-25T18:00:00Z",
  "notes": "不要忘記買牛奶"
}

查詢提醒

# 示例：列出指定列表中的未完成提醒
{
  "command": "list_reminders",
  "filter": {
    "list": "工作",
    "showCompleted": false
  }
}

更新提醒狀態

# 示例：將特定提醒標記為已完成
{
  "command": "update_reminder_status", 
  "reminderId": 123,
  "completed": true
}

⚠️ 注意事項

⚠️ 重要提示

• 在 macOS 系統中，確保應用程序有權限訪問 Apple 提醒服務，可能需在系統偏好設置中進行授權。
• 建議在不同的 macOS 版本上進行測試，以驗證插件的兼容性。
• 由於直接操作本地提醒數據庫，可能會遇到與其他客戶端（如 iCloud）數據不同步的問題，請確保定期手動同步。

🤝 貢獻指南

歡迎貢獻代碼或提出問題與建議。請參考項目倉庫中的 CONTRIBUTING.md 文件瞭解具體的協作流程和規範。

📄 許可證

本項目遵循 MIT 許可證協議，具體內容可見項目的 LICENSE 文件。

通過以上步驟和配置，您能夠順利地在 macOS 系統中實現 Apple 提醒服務與 MCP 服務器的集成，從而增強任務管理的效率。