Apple Calendars

🚀 MCP Apple 日曆

這是一個用於在 macOS 上與蘋果日曆交互的模型上下文協議 (MCP) 服務器。該模塊為 AI 模型提供了標準化接口，使其能夠方便地訪問和操作日曆數據。

🚀 快速開始

在使用 MCP Apple 日曆之前，需要滿足以下先決條件：

• macOS 12.0 或更高版本
• Node.js 16.0 或更高版本
• 日曆 API 橋接 在本地運行

📦 安裝指南

按照以下步驟進行安裝：

1. 克隆此倉庫
2. 安裝依賴項：

   npm install
   

3. 構建 TypeScript 代碼：

   npm run build
   

💻 使用示例

基礎用法

使用前請確保日曆 API 橋接正在 8080 端口運行，然後啟動 MCP 服務器：

npm start

高級用法

若要以開發模式運行服務器並啟用自動重新加載，可執行以下命令：

npm run dev

✨ 主要特性

MCP 服務器為 AI 模型提供了一系列實用工具：

• getCalendars：列出所有可用日曆
• getCalendarEvents：從特定日曆獲取事件
• createCalendarEvent：在日曆中創建新事件
• updateCalendarEvent：更新現有事件
• deleteCalendarEvent：從日曆中刪除事件

📚 詳細文檔

日期格式

在創建或更新事件時，支持以下幾種日期格式：

1. 帶有毫秒和 Z 時區的 ISO8601（推薦）：

   2025-03-09T10:00:00.000Z
   

2. 不帶毫秒的 ISO8601：

   2025-03-09T10:00:00
   

3. 使用空格代替 T 的 ISO8601：

   2025-03-09 10:00:00
   

4. 帶有斜槓的 ISO8601：

   2025/03/09 10:00:00
   

日曆 API 橋接已更新以自動處理這些日期格式。

📄 許可證

本項目採用 MIT 許可證。