日历数据交互协议

一个用于与macOS上的Apple日历交互的模型上下文协议(MCP)服务器,提供标准化的日历数据访问和操作接口。

  • by shadowfax92
  • TypeScript
  • 本地部署
  • 14 星标
  • 更新于
在 GitHub 查看 shadowfax92/apple-calendar-mcp

使用说明

MCP苹果日历

用于在macOS上与Apple日历交互的模型上下文协议(MCP)服务器。该模块允许AI模型通过标准化界面访问和操作日历数据。

先决条件

  • macOS 12.0或更高版本
  • Node.js 16.0或更高版本
  • 日历API桥 在本地运行

安装

  1. 克隆此存储库
  2. 安装依赖项:
    npm install
    
  3. 构建TypeScript代码:
    npm run build
    

用法

  1. 请确保日历API桥正在端口8080上运行
  2. 启动MCP服务器:
    npm start
    

可用工具

MCP服务器为AI模型提供以下工具:

  • getCalendars:列出所有可用日历
  • getCalendarEvents:从特定日历中获取事件
  • createCalendarEvent:在日历中创建新事件
  • updateCalendarEvent:更新现有事件
  • deleteCalendarEvent:从日历中删除事件

日期格式

创建或更新事件时,您可以使用以下任何日期格式:

  1. ISO8601,毫秒和Z时区(推荐):

    2025-03-09T10:00:00.000Z
    
  2. ISO8601,无毫秒:

    2025-03-09T10:00:00
    
  3. ISO8601,用空格代替T:

    2025-03-09 10:00:00
    
  4. 带正斜杠的ISO8601:

    2025/03/09 10:00:00
    

日历API桥已更新,可自动处理这些日期格式。

发展

要在开发模式下运行服务器并自动重新加载,请执行以下操作:

npm run dev

许可证

麻省理工学院