核心用法
Temporal Cortex 是面向 Claude、Cursor、Windsurf 等 AI 客户端的日历调度 MCP 技能集,采用分层架构设计:
双层子技能架构
- temporal-cortex-datetime(L1):零配置的时区/时间计算层,处理自然语言转时间戳、时区转换、持续期运算,无需任何凭证即可工作
- temporal-cortex-scheduling(L2-L4):需OAuth认证的日历操作层,覆盖发现、查询、可用性检测、预约全流程
标准五步法:发现日历 → 获取当前时间 → 解析时间意图 → 查询冲突 → 确认预约。强制要求 booking 前执行 check_availability,杜绝撞期。
显著优点
1. 跨平台统一:原生支持 Google Calendar、Microsoft Graph(Outlook/Exchange)、标准 CalDAV,单接口屏蔽厂商差异
2. 安全优先设计:
3. 时区鲁棒性:强制通过 get_temporal_context 获取当前时间,杜绝本地时间假设导致的全球协作事故
4. 供应链透明:GitHub Actions 公开构建,5 平台交叉编译,源码与校验和独立可审计
- 凭证本地隔离存储于
~/.config/temporal-cortex/,零云端回传 - 事件内容经 prompt injection 防火墙过滤
- Rust 编译二进制,npm 包内嵌 SHA256 校验,安装失败即中止而非静默执行
- 可 Docker 沙箱运行,仅挂载配置目录
潜在局限
- OAuth 配置门槛:首次使用需执行
npx @temporal-cortex/cortex-mcp auth <provider>,对终端用户不够零摩擦 - Node.js 依赖:虽提供 Docker 方案,但默认 npx 路径仍需 Node 18+ 环境
- RRULE 复杂度:
expand_rrule对复杂重复规则(如按第 N 个工作日)的边界处理需人工复核 - 外部预约链路:
request_booking依赖对方 Temporal Link 生态,渗透率受限时体验降级
适合人群
- 高频跨时区协作的远程团队/分布式企业
- 已在使用 Claude Code、Cursor 等 AI 编程环境的开发者
- 对日历数据主权敏感、拒绝 SaaS 托管 credentials 的隐私优先用户
- 需要批量自动化日程管理(如智能客服预约系统)的集成商
常规风险
| 风险维度 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 凭证泄露 | OAuth token 本地文件被其他进程读取 | 文件权限 600,Docker 模式隔离 volume |
| 供应链攻击 | npm 包或 GitHub Release 被篡改 | 独立校验 SHA256SUMS.txt,启用 checksum 安装阻断 |
| 时区误算 | 夏令时切换或 ambiguous 时间解析错误 | 强制使用 IANA tzdb,拒绝模糊时间输入 |
| 过度授权 | MCP server 请求超出必要的日历权限 | 细粒度 OAuth scope,可审计 token 范围 |
| 冲突漏检 | 并发预约导致 race condition | 原子性 `check_availability` → `book_slot` 链式调用,依赖服务端乐观锁 |