system-time

🕐 零依赖的精准时间管家

基于官方MCP SDK的轻量级时间工具,支持多格式输出、全球时区转换与时间差计算,零外部依赖,开箱即用。

收藏
784
安装
298
版本
0.1.0
CLS 安全性认证2026-05-21
点击查看完整报告 >

使用说明

核心用法

system-time 是一款专注于时间处理的 MCP Skill,提供三类核心工具:

1. get_current_time:获取当前系统时间,支持 ISO 8601、日期、时间、完整中文格式、Unix 时间戳等 6 种输出格式,并可指定全球任意 IANA 时区(如 Asia/Shanghai、America/New_York)。

2. get_time_info:返回结构化的时间详情,包含年月日、星期、时分秒毫秒、时间戳、ISO 格式及本地/UTC 双时区信息,便于程序解析和展示。

3. calculate_time_diff:计算两个时间点之间的差值,支持 ISO 字符串或时间戳输入,自动输出天、小时、分钟、秒等多单位结果。

显著优点

  • 零依赖风险:仅依赖官方 @modelcontextprotocol/sdk,无第三方网络库或文件操作模块
  • 功能聚焦:单一职责设计,API 简洁直观,学习成本极低
  • 国际化支持:内置全球时区转换,满足跨地域协作需求
  • 多格式兼容:覆盖开发、办公、数据分析等场景的格式需求
  • 类型安全:TypeScript 编写,编译时类型检查完善

潜在缺点与局限性

  • 功能边界清晰:仅处理时间获取与计算,不支持定时任务调度、闹钟提醒等主动触发功能
  • 无网络时间校准:依赖本地系统时间,若系统时间被篡改则结果不准确
  • 时区数据依赖运行时:时区规则更新需依赖 Node.js 环境升级
  • 作者为独立开发者:非官方 MCP 团队维护,长期更新承诺需观察

适合的目标群体

  • 需要跨时区时间转换的国际化团队
  • 开发日志、数据报表等需要标准时间戳的后端开发者
  • 构建聊天机器人、客服系统需友好时间展示的 AI 应用开发者
  • 对安全性要求极高、希望最小化依赖的攻击面敏感型用户

使用风险

  • 性能风险:极低,纯内存计算,无 I/O 操作
  • 依赖风险:官方 SDK 版本锁定,供应链攻击面可控
  • 准确性风险:依赖本地系统时钟,关键场景建议配合 NTP 校准
  • 维护风险:社区驱动,建议锁定版本使用

安全解读

核心用法

System Time 是一款基于 MCP 协议的本地时间工具,提供三大核心功能:

1. 获取当前时间get_current_time)——支持 ISO 8601、日期、时间、完整中文、Unix 时间戳等 6 种输出格式,并可指定全球任意时区
2. 时间详情拆解get_time_info)——返回年、月、日、星期、毫秒级时间戳、本地与 UTC 时间等完整元数据

3. 时间差计算calculate_time_diff)——支持 ISO 格式或时间戳输入,自动输出天、小时、分钟、秒的多单位差值

显著优点

  • 零网络依赖:纯本地 JavaScript Date API 计算,无外部 API 调用,离线可用
  • 多格式兼容:覆盖开发调试、日志记录、用户展示等全场景时间格式需求
  • 全球化支持:内置 IANA 时区数据库支持,轻松实现跨时区协作与转换
  • 极简集成:基于官方 MCP SDK,一行代码即可接入现有 AI 工作流

潜在局限

  • 无网络授时:依赖本地系统时钟,若系统时间不准则输出存在偏差
  • 功能边界清晰:仅聚焦时间查询与计算,不支持定时任务调度、闹钟提醒等高级功能
  • T3 来源:个人开发者维护,长期更新与社区支持能力有待观察

适合人群

  • 需要为 AI Agent 快速添加时间感知能力的开发者
  • 跨时区团队协作工具、日志系统、数据报表的构建者
  • 对隐私敏感、要求工具完全离线运行的企业环境

常规风险

  • 极低风险,但需注意:若未来版本引入 NTP 网络校时功能,需重新评估网络层安全

system-time 内容

dist文件夹
src文件夹
手动下载zip · 10.7 kB
index.d.tstext/plain
请选择文件