MCP Apple 日历

这是一个用于在 macOS 上与 Apple 日历进行交互的模型上下文协议（MCP）服务器。此模块允许AI模型通过标准化接口访问和操作日历数据。

预备条件

• macOS 12.0 或更高版本
• Node.js 16.0 或更高版本
• 在本地运行的 Calendar API Bridge

安装

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 构建 TypeScript 代码：

   npm run build
   

使用方法

1. 确保 Calendar API Bridge 在 8080 端口上运行
2. 启动 MCP 服务器：

   npm start
   

提供的工具

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
   

Calendar API Bridge 已经更新以自动处理这些日期格式。

开发

要在开发模式下运行服务器并实现自动重新加载：

npm run dev

许可证

MIT

</中文翻译>