mcp-ical 的安装和配置教程

项目基础介绍

mcp-ical 是一个开源项目，它允许用户通过自然语言与 macOS 日历进行交互。该项目利用了 Model Context Protocol (MCP) 实现了一个服务器，用户可以通过自然语言命令来创建、查看和管理日历事件。

主要编程语言

该项目主要使用 Python 语言开发。

关键技术和框架

• Model Context Protocol (MCP): 是一个允许应用程序之间以自然语言进行交互的协议。
• PyObjC: 一个可以让 Python 程序员编写 macOS 应用程序的工具。

准备工作

在开始安装之前，请确保您的系统满足以下要求：

• 操作系统: macOS
• Python: 安装了 Python 环境
• uv package manager: 安装了 uv 包管理器
• iCloud Calendar: 如果需要与 Google Calendar 同步，请确保已经将 Google Calendar 与 iCloud Calendar 同步

安装步骤

克隆项目

首先，您需要在您的计算机上克隆这个项目。打开终端，执行以下命令：

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

安装依赖

接着，使用 uv 包管理器来安装项目依赖：

uv sync

配置 Claude for Desktop

为了能够使用 mcp-ical 服务器，您需要配置 Claude for Desktop 以使用该服务器。首先，创建或编辑配置文件 claude_desktop_config.json：

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

请将 "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical" 替换为您的实际项目路径。

启动 Claude for Calendar Access

在终端中运行以下命令以启动 Claude 应用程序：

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

请注意， Claude 必须从终端启动才能正确请求日历权限。直接从 Finder 启动将不会触发权限提示。

授权

首次使用与日历相关的命令时，macOS 将提示您授权访问日历。此提示仅在您按照上述步骤从终端启动 Claude 时出现。

现在，您可以开始使用 mcp-ical 服务器，并通过自然语言命令管理您的日历事件了。