核心用法
Temporal Cortex Datetime 是一套专为 MCP 生态设计的离线时间处理工具集,通过 5 个原子化工具覆盖完整的时序操作需求:
1. `get_temporal_context` — 会话启动必调,获取当前 UTC/本地时间、IANA时区、DST状态、ISO周次等完整上下文
2. `resolve_datetime` — 将 60+ 种自然语言表达式(如 "next Tuesday at 2pm"、"third Friday of March")解析为标准 RFC 3339 格式
3. `convert_timezone` — 带 DST 智能处理的时区转换
4. `compute_duration` — 计算两个时间戳间的精确时长(天/小时/分钟/秒)
5. `adjust_timestamp` — DST 感知的时间偏移,跨夏令时切换保持 wall-clock 时间一致
显著优点
完全离线运行:Rust 编译的二进制通过 npm 一次性分发,安装后零网络访问、零文件写入、零凭证依赖。Docker 模式更可启用 --network=none 实现操作系统级网络隔离。
安全可审计:构建流程完全开源(GitHub Actions 交叉编译),每个版本发布独立 SHA256 校验和,安装脚本内置哈希校验(不匹配则终止执行),支持用户独立验证。
DST 精确处理:区别于简单的偏移量计算,工具内置 IANA 时区数据库,能正确处理全球各地区的夏令时切换边界(如 spring-forward 时 +1d 保持 23:00 不变)。
自然语言解析:支持相对时间、周期边界、序数星期等复杂表达式,降低用户输入门槛。
潜在局限
- Node.js 依赖:首次安装需 npx/Node.js 18+ 或 Docker,对纯浏览器环境不友好
- 无持续同步:依赖系统时钟,长期运行的会话需周期性重调
get_temporal_context - 仅处理公历:不支持农历、伊斯兰历等其他历法
- 配置文件单一:仅读取
~/.config/temporal-cortex/config.json,无多配置文件切换机制
适合人群
- 隐私敏感用户(零云端交互、零遥测)
- 跨时区协作团队(自然语言转标准时间戳)
- 自动化工作流开发者(可靠的 DST 计算避免会议时间错误)
- 安全审计环境(可 Docker 隔离、可源码审计)
常规风险
| 风险类别 | 说明 |
|---------|------|
| 供应链攻击 | npm 包下载阶段存在中间人风险,建议通过独立校验 GitHub Release 的 SHA256SUMS.txt 验证 |
| 时区数据过期 | 内置 IANA 数据库需随版本更新,旧版本可能无法处理新宣布的 DST 变更 |
| 解析歧义 | 自然语言如 "next week" 存在主观解释差异,工具依赖预设 WEEK_START 配置 |
| 容器逃逸 | Docker 模式建议配合 seccomp/apparmor 使用,尽管二进制本身无特权操作 |