MCP iCal Server
2025.02.11
61
Python自然语言日历管理macOS 日历集成日程管理
mcp-ical 是一个基于 Model Context Protocol (MCP) 的自然语言日历管理服务，专为 macOS 设计。它允许用户通过自然语言与日历进行交互，实现事件的创建、查询、修改和管理。核心功能包括自然语言事件创建、智能日程管理、事件更新和日历管理。适用于需要高效管理日程的个人和团队。
View on GitHub
Overview
🌟 基本能力
产品定位
mcp-ical 是一个自然语言日历管理服务，专为 macOS 设计，旨在通过自然语言交互简化日历管理。
核心功能
- 自然语言事件创建：将自然语言转换为日历事件，支持自定义日历选择、地点、备注、智能提醒和重复事件。
- 智能日程管理：通过自然语言查询日程，显示即将到来的事件和可用时间段。
- 事件更新：支持时间、日期、地点、备注、提醒和重复模式的修改。
- 日历管理：查看和管理所有可用日历，支持 Google Calendar 集成。
适用场景
- 个人日程管理：快速添加、查询和修改个人日程。
- 团队协作：安排团队会议和活动。
- 多日历管理：在多个日历之间切换和管理事件。
工具列表
- uv 包管理器：用于安装和管理依赖。
- Claude for Desktop：推荐的 MCP 客户端，用于与 mcp-ical 交互。
常见问题解答
- 重复事件：非标准重复计划可能无法正确设置，建议使用 Claude 3.5 Sonnet 以获得更好的效果。
- 权限问题：首次使用时需从终端启动 Claude 以触发日历权限提示。
🚀 使用教程
使用依赖
- 安装 uv 包管理器：
# 安装 uv 包管理器
# 参考链接：https://github.com/astral-sh/uv
- 确保 macOS 日历应用已配置。
- 安装 MCP 客户端（推荐 Claude for Desktop）：
# 下载 Claude for Desktop
# 参考链接：https://claude.ai/download
安装教程
- 克隆仓库并设置：
git clone https://github.com/yourusername/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
调试方式
- 运行测试套件：
uv sync --dev
uv run pytest tests
- 测试时会创建临时日历和事件，建议仅在开发环境中运行测试。