time

Name: time
Author: rog0x

本地服务

github.com/rog0x生产力032 周前更新

代码仓库

关于 time

为 AI Agent 提供日期、时间和时区处理工具的 MCP 服务，基于 JavaScript 原生 Date 和 Intl API。功能还包括 cron 表达式、时间戳与时长转换。

主要功能

01转换时区并比较时区时间差
02计算日期差、工作日及日期偏移
03解析、验证和生成 cron 表达式
04转换 Unix 时间戳与日期
05解析和格式化时长并计算倒计时

适用场景

01查看多个时区的当前时间
02计算项目日期和工作日间隔
03检查定时任务并查看后续运行时间
04转换时间戳或计算距离目标时间的剩余时长

MCP 相关

作为 MCP 服务，向 AI Agent 提供时区、日期、cron、时间戳和时长处理工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "rog0x-time": {
      "command": "npx",
      "args": [
        "-y",
        "@rog0x/mcp-time-tools"
      ]
    }
  }
}

启动命令npx -y @rog0x/mcp-time-tools

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@rog0x/mcp-time-tools1.0.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
datetime	string	是	日期/时间字符串（ISO 8601 或常见格式，例如 2025-06-15T14:30:00）
to_timezone	string	是	目标时区（例如 Asia/Tokyo）
from_timezone	string	是	源时区（例如 America/New_York）

详细介绍

mcp-time-tools

通过 Model Context Protocol（MCP）为 AI Agent 提供日期、时间和时区工具。

完全使用原生 JavaScript Date 和 Intl API 构建，无需外部日期库。

工具

时区转换器

convert_timezone —— 将日期/时间从一个时区转换为另一个时区
list_timezones —— 列出常用时区及当前 UTC 偏移量
current_time_multi —— 同时显示多个时区的当前时间
time_difference —— 计算两个时区之间的时差

日期计算器

date_add_subtract —— 为日期增加或减去天、周、月或年
date_difference —— 以不同单位计算两个日期之间的差值
business_days —— 计算两个日期之间的工作日数，或为日期增加工作日

Cron 解析器

parse_cron —— 将 cron 表达式解析为易读的描述
cron_next_runs —— 计算 cron 表达式接下来的 N 次执行时间
validate_cron —— 验证 cron 表达式并说明错误
generate_cron —— 根据易读的描述生成 cron 表达式

时间戳转换器

timestamp_to_date —— 将 Unix 时间戳（秒或毫秒）转换为易读格式
date_to_timestamp —— 将日期/时间字符串转换为 Unix 时间戳
current_timestamp —— 获取当前 Unix 时间戳以及格式化后的日期/时间

时长格式化工具

format_duration —— 将秒数转换为易读的时长（例如 2 小时 30 分钟 15 秒）
parse_duration —— 将易读的时长字符串解析为秒数
time_ago —— 计算相对时间描述（例如“5 分钟前”）
countdown —— 计算距离目标日期/时间的剩余时间

设置

npm install
npm run build

与 Claude Desktop 配合使用

将以下内容添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "time-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-time-tools/dist/index.js"]
    }
  }
}

开发

npm install
npm run build
npm start

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。