首页
/ mcp-ical 的安装和配置教程

mcp-ical 的安装和配置教程

2025-05-21 08:48:34作者:裴麒琰

项目基础介绍

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 服务器,并通过自然语言命令管理您的日历事件了。

登录后查看全文
热门项目推荐