MCP Apple 日历

一个用于在 macOS 上与 Apple 日历交互的 Model Context Protocol (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