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 许可证。