使用说明

项目简介

iCal Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在通过自然语言简化 macOS 日历的管理。它允许用户使用日常口语与日历进行交互，例如创建、查询和更新日历事件，极大地提升了日历使用的便捷性和效率。

主要功能点

自然语言事件创建：将自然语言指令转换为日历事件，例如 "下周四下午 1 点在 Bistro Garden 安排团队午餐"。
智能日程管理与查询：快速查询日程安排和空闲时间，例如 "下周我的日程安排是什么？" 或 "下周二什么时候我有空开会 2 小时？"。
智能化事件更新：自然地修改现有事件，例如 "把明天的团队会议改到下午 3 点"。
日历管理：支持查看所有可用日历，并能与同步到 iCloud 的 Google 日历无缝集成。

安装步骤

克隆仓库 打开终端，执行以下命令克隆 iCal Server 仓库到本地：

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

安装依赖 确保您已安装 uv 包管理器。然后，在仓库目录下运行以下命令安装项目依赖：
```
uv sync
```

服务器配置

要将 iCal Server 与 MCP 客户端（例如 Claude for Desktop）连接，您需要配置客户端的 MCP 服务器设置。以下是 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"
            ]
        }
    }
}

配置参数说明:

'"mcp-ical"': 服务器名称，可以自定义，用于在 MCP 客户端中标识该服务器。
'"command": "uv"': 启动服务器的命令，这里使用 'uv' 运行 Python 脚本。
'"args"': 传递给 'uv' 命令的参数列表。
- '"--directory"': 指定项目根目录的绝对路径，请将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical' 替换为您的 'mcp-ical' 仓库所在的父文件夹的绝对路径。 例如，如果您的 'mcp-ical' 仓库在 '/Users/yourusername/Documents/mcp-ical'，则父文件夹路径为 '/Users/yourusername/Documents'。
- '"run"': 'uv run' 命令用于运行指定的 Python 脚本。
- '"mcp-ical"': 指定要运行的 Python 脚本名称，默认为 'mcp-ical'，对应 'src/mcp_ical/server.py' 文件。

基本使用方法

启动 Claude for Desktop 务必从终端启动 Claude for Desktop，以便正确请求日历权限。在终端中执行：
```
/Applications/Claude.app/Contents/MacOS/Claude
```
注意： 首次使用日历相关命令时，macOS 会弹出日历访问权限请求，请务必允许。

开始使用 在 Claude for Desktop 中，您可以尝试使用自然语言命令来操作日历，例如：

What's my schedule looking like for next week?

或

Add a lunch meeting with Sarah tomorrow at noon

Claude 会调用 iCal Server 来执行日历操作，并返回结果。

关键词