Temporal Cortex MCP 是一个面向 AI 智能体的开放调度基础设施，目标是让任意 AI 智能体具备可靠自主的日程安排能力。无论对话方是否使用 AI 智能体、使用 Google Calendar 还是 Outlook、回复是即时还是延迟数天，均可完成调度。项目当前版本为 v0.9.1（2026 年 3 月），采用 Rust 编写，通过 npm 和 Docker 分发。
【用途】 解决 AI 智能体在日历任务中常见的失败：即使是最新的 LLM 在时间推理任务上得分也低于 50%，早期模型在调度任务上低至 29%、时长计算低至 13%。常见问题包括选错“下周二”、时区判断错误、重复预订日历。多数面向 AI 的日历工具只是薄薄的 CRUD 封装，不具备时间感知、冲突检测和安全兜底。Temporal Cortex 通过确定性的时序计算层（Truth Engine）提供时间感知、原子预订、计算可用性、确定性 RRULE 展开与 token 高效输出。
【主要能力】
- 时间感知：智能体可调用 get_temporal_context 获取真实时间与时区；resolve_datetime 将“下周二下午 2 点”转为精确的 RFC 3339 时间戳，避免幻觉。
- 原子预订：先锁定时间段、验证无冲突再写入。两个智能体争抢同一时段时，恰好一个成功，另一个收到明确错误，避免重复预订，采用两阶段提交（Two-Phase Commit）。
- 计算可用性：将多个日历的空闲/忙碌数据合并为统一视图，让 AI 看到真实的可用性，而非需要自行解读的原始事件列表。
- 确定性 RRULE 展开：依据 RFC 5545 处理夏令时切换、BYSETPOS=-1（每月最后一个工作日）、带时区的 EXDATE、闰年重复以及 INTERVAL>1 配合 BYDAY 等边缘情况，不依赖 LLM 推断。
- Token 高效输出：TOON（Token-Oriented Object Notation）格式比标准 JSON 压缩约 40% 的 token，降低成本和上下文窗口占用。TOON 是所有数据工具的默认输出格式，可通过 format: "json" 显式获取 JSON。
- 工具规模：共 18 个工具、分 5 层。15 个核心工具始终可用，3 个额外的 Open Scheduling 工具仅在平台模式可用。5 层分别为：Layer 0 发现、Layer 1 时间上下文、Layer 2 日历操作、Layer 3 可用性、Layer 4 预订。
- 协议支持：MCP、A2A、REST、浏览器。
- 框架集成：LangGraph、CrewAI、OpenAI Agents SDK。
【使用方式】 两种使用路径：
- 个人用户：连接日历后由 AI 智能体处理可用性检查、时区解析和会议预订。兼容 Claude Desktop、Cursor、OpenClaw、Manus 及任何兼容 MCP 的 AI 客户端。安装命令为 npx @temporal-cortex/cortex-mcp，设置向导会交互式引导完成服务商认证、时区配置和 MCP 客户端设置。
- 开发者/产品：为 AI 智能体或产品添加调度能力，可使用本地 MCP 服务器（npx @temporal-cortex/cortex-mcp，完整工具套件、零基础设施）、平台 REST API（app.temporal-cortex.com，托管、API key、用量面板、Open Scheduling 网络）或框架集成。REST API 参考见 temporal-cortex.com/docs/rest-api。 手动设置三步：安装前置条件（Node.js 18+ 或 Docker，以及至少一个日历服务商）；在 AI 客户端配置文件中添加 MCP 配置；运行认证流程 npx @temporal-cortex/cortex-mcp auth google（或 outlook / caldav），该流程同时配置时区、每周起始日和遥测偏好。 认证：最简单的方式是运行 npx @temporal-cortex/cortex-mcp setup，一次性完成认证、配置和 MCP 客户端设置。各服务商单独认证时，凭据保存到 ~/.config/temporal-cortex/credentials.json，服务商注册到 ~/.config/temporal-cortex/config.json。可连接多个服务商，服务器启动时自动发现所有已配置服务商并合并日历为统一视图。认证过程中会交互式引导设置：时区（自动检测系统时区，并提供全部 597 个 IANA 时区的模糊搜索选择器）、每周起始日（周一 ISO 标准或周日）、遥测（可选匿名数据，默认关闭）。偏好存储于 ~/.config/temporal-cortex/config.json，可通过 TIMEZONE 和 WEEK_START 环境变量按会话覆盖。 服务商凭据要求：Google Calendar 需要 Google OAuth 凭据；Microsoft Outlook 需要 Azure AD 应用注册（MICROSOFT_CLIENT_ID）；CalDAV（iCloud、Fastmail 等）需要应用专用密码。 平台模式：无需本地 Node.js 或本地 OAuth 凭据。在 app.temporal-cortex.com 注册，通过仪表板用 OAuth 连接 Google Calendar 或 Microsoft Outlook，生成 API key，再将 MCP 配置添加到 AI 客户端。平台能力包括：无需管理 OAuth 凭据、无需 Node.js（客户端通过 HTTP 直连云端端点）、用量仪表板、托管日历连接（token 刷新、重新认证、服务商健康检查由服务端处理）、多智能体协调（分布式锁防止并发预订冲突）、用量计量（按智能体和团队跟踪工具调用）、内容防火墙（自动提示注入检测与零宽度 Unicode 剥离）、基于调用方的策略（按智能体强制预订规则，如最长时长、允许时段、预订上限）。全部 15 个核心工具和 5 层在两种模式下行为一致。 Open Scheduling 与 Temporal Links：平台用户可启用 Open Scheduling，使可用性可被 AI 智能体和人类公开查询，无需 API key。在仪表板 Settings > Scheduling 中设置 slug 并启用，分享 Temporal Link（如 book.temporal-cortex.com/billy）。调用方可通过 Agent Card 发现、REST 查询可用性、REST 预订、A2A JSON-RPC 调用 query_availability 或 book_slot、身份解析等接口访问。同一链接在浏览器中也可用，人类会看到带日期/时间选择器和表单的预订页面。 安装校验：每次 GitHub Release 都会发布 SHA256 校验和，并作为 checksums.json 嵌入 npm 包用于安装后自动校验。postinstall 脚本下载平台专用二进制并对比 SHA256 哈希，不匹配则安装失败并给出期望与实际哈希。二进制通过 GitHub Actions 从 Rust 源码跨平台编译，覆盖 darwin-arm64、darwin-x64、linux-x64、linux-arm64、win32-x64。计算层开源于 temporal-cortex/core。可通过 Docker 容器运行以获得最大隔离，无需在宿主机安装 Node.js。
【适用场景】
- 为 AI 智能体或产品添加自主日程安排能力。
- 需要跨多个日历服务商合并可用性并防止重复预订的场景。
- 需要确定性处理复杂重复规则（夏令时、月末工作日、闰年等）的日程系统。
- 希望通过 Open Scheduling 公开可查询可用性、接受 AI 或人类预订的个人或团队。
【限制】
- 本地模式需要 Node.js 18+（或 Docker），以及至少一个日历服务商的认证凭据。
- 不同服务商需分别准备 OAuth 凭据或应用专用密码，具体步骤未在资料中完整展开。
- 3 个额外的 Open Scheduling 工具仅在平台模式可用。
- 平台模式的收费、价格与配额等信息资料中暂未提供。
- 具体工具输入/输出 schema 与示例见 docs/tools.md，资料中未逐项列出。