MCP iCal 服务器：macOS 日历的自然语言管理

1. 项目介绍

MCP iCal 是一个基于 Model Context Protocol (MCP) 的服务器，它能够让用户通过自然语言与 macOS 日历进行交互。这个项目将日历管理转化为一种对话体验，允许用户以更直观、更人性化的方式管理日程。

2. 项目快速启动

环境准备

• 确保你的系统已经安装了 uv 包管理器。
• 确保你的 macOS 系统已经配置好了日历应用。
• 下载并安装 MCP 客户端，例如 Claude for Desktop。

克隆和设置

首先，克隆项目仓库到本地：

git clone https://github.com/Omar-V2/mcp-ical.git
cd mcp-ical

接着，安装依赖：

uv sync

配置 Claude for Desktop，编辑或创建 ~/Library/Application Support/Claude/claude_desktop_config.json 文件：

{
  "mcpServers": {
    "mcp-ical": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical",
        "run",
        "mcp-ical"
      ]
    }
  }
}

启动 Claude 以访问日历：

/Applications/Claude.app/Contents/MacOS/Claude

注意：必须从终端启动 Claude 以请求日历权限。从 Finder 直接启动将不会触发权限提示。

3. 应用案例和最佳实践

创建事件

使用自然语言创建日历事件：

"安排一个和 Sarah 的午餐会议，明天中午。"

查看日程

快速查看你的日程：

"下周我的日程是什么？"

修改事件

自然地修改事件：

"将明天的团队会议改为下午3点。"

查看日历

查看所有可用的日历和智能推荐的日历。

处理 recurring 事件

创建和修改 recurring 事件，注意非标准的 recurring 计划可能不会总是设置正确。

提醒设置

为事件添加智能提醒，但要注意 recurring 全天事件的提醒时间可能会相差一天。

4. 典型生态项目

MCP iCal 可以作为生态系统中的一个节点，与其他 MCP 兼容的项目和工具一起工作，形成一个更加强大和灵活的自动化和日历管理系统。探索与 MCP 相关的其他开源项目，可以进一步扩展你的日历管理能力。