mcp-ical

🚀 MCP ical 服务器

MCP ical 服务器可让你在 macOS 上以自然语言的方式管理日历，借助模型上下文协议（MCP），将日历管理转变为对话式体验，极大提升交互效率。

🚀 快速开始

前提条件

• macOS (10.9 或更高版本)
• Python 3.12+
• Claude 应用程序

启动步骤

1. 下载并安装 Claude 应用。
2. 在终端中运行启动命令：

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

✨ 主要特性

📅 事件创建

可立即将自然语言转换为日历事件。

"安排下周四下午 1 点与团队共进午餐"
↓
📎 创建：团队午餐
   📅 星期四，下午 1:00
   📍 Bistro Garden

功能包括

• 快速添加：通过简单的语言指令创建事件。
• 智能解析：自动识别日期、时间及相关细节。

智能日程管理

尝试："下周的安排是什么？"

事件更新

可使用自然语言更新现有事件，如："将下周四的午餐改为下午 2 点。"

💻 使用示例

基础用法

你: "下周的安排是什么？"
Claude: "让我为您查看..."
[显示一周的清晰概览]

高级用法

"安排下周四下午 1 点与团队共进午餐"
↓
📎 创建：团队午餐
   📅 星期四，下午 1:00
   📍 Bistro Garden

🧪 测试

# 安装开发依赖项
uv sync --dev

# 运行测试套件
uv run pytest tests

🐛 已知问题

重复事件

• 非标准的重复安排可能无法正确设置。
• 使用 Claude 3.5 Sonnet 效果更佳。
• 所有日事件的提醒时间可能会错一天。

🤝 贡献

欢迎反馈和贡献，步骤如下：

1. 叉库克隆仓库。
2. 创建功能分支。
3. 提交更改。
4. 推送到分支。
5. 提交拉取请求。

📄 许可证

本项目采用 MIT 许可证，详情请见 LICENSE 文件。

🙏 致谢

• 使用 模型上下文协议 构建。
• macOS 日历集成使用 PyObjC。