核心用法
Temporal Cortex Datetime 是专为 MCP 客户端设计的本地离线时间处理工具集,包含 5 个核心工具:get_temporal_context 用于获取当前时间上下文,resolve_datetime 将 60+ 种自然语言表达式转换为 RFC 3339 标准时间,convert_timezone 实现 IANA 时区间的精确转换,compute_duration 计算时间间隔,adjust_timestamp 提供 DST 感知的时间调整。安装方式灵活,支持 npx 一键安装或 Docker 完全隔离部署,安装后所有运算完全离线执行。
显著优点
极致离线安全:运行时零网络访问、零文件写入、零凭证依赖,通过 Docker --network=none 可在操作系统层面强制断网。安装阶段的 npm 下载为一次性行为,后续启动完全本地执行。
DST 智能处理:adjust_timestamp 在夏令时切换期间保持墙钟时间一致性(如跨越 spring-forward 的 +1d 调整仍返回相同时刻),避免常见时区计算错误。
自然语言解析:支持 60+ 种表达模式,涵盖相对时间("tomorrow")、序数星期("third Friday of March")、复合表达式("next Tuesday at 2pm")等,显著降低用户输入门槛。
供应链透明:Rust 源码 MIT 开源,GitHub Actions 跨平台编译(darwin/linux/win32,arm64/x64),发布时附带独立 SHA256SUMS.txt,安装脚本内置校验且哈希不匹配时自动终止,支持用户独立验证。
潜在缺点与局限性
Node.js 依赖门槛:需 Node.js 18+ 或 Docker 环境,对纯浏览器/移动端场景不友好。
配置有限:仅支持 ~/.config/temporal-cortex/config.json 单一配置文件,无法通过环境变量动态调整,多用户场景需手动管理配置。
表达式边界:自然语言解析虽覆盖常见场景,但对模糊表达(如"下月初的工作日")可能产生歧义,建议关键场景先用 resolve_datetime 验证输出。
平台覆盖缺口:未提供 win32-arm64 预编译二进制,Windows on ARM 用户需自行从源码构建。
适合人群
- 对数据隐私敏感的开发者(金融、医疗、法律场景)
- 需处理多时区协作的全球化团队
- 追求供应链可审计的安全从业者
- 希望自然语言交互替代复杂日期库调用的产品经理/运营人员
常规风险
供应链攻击面:虽有多层校验,但 npm registry 与 GitHub Releases 仍为信任锚点,极端场景下需验证发布签名。
时区数据时效性:IANA 时区数据库内嵌于二进制,若 TZDB 规则变更(如国家取消 DST)需等待新版本发布。
Docker 镜像漂移:自行构建时若未锁定 commit hash,可能拉取非预期源码版本,建议显式指定 git ref。