clockport

Name: clockport
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords生产力03 天前更新

代码仓库

关于 clockport

clockport 是用于查询 IANA 时区当前时间及跨时区换算的命令行工具和 MCP 服务。它通过 Node 的 Intl 时区数据处理夏令时变化。

主要功能

01按 IANA 时区查询当前时间
02转换不同时区的时间
03结果考虑夏令时

适用场景

01查询其他城市的当前时间
02换算跨时区会议时间

MCP 相关

其 stdio MCP 服务提供查询指定时区当前时间、转换源时区与目标时区时间的工具。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-clockport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/clockport"
      ]
    }
  }
}

启动命令npx -y @reneturcios/clockport

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

安装包

npm@reneturcios/clockport0.1.0stdio

ocighcr.io/cloudcorprecords/clockport:0.1.0stdio

工具

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

参数	类型	必填	说明
timezone	string	是	IANA 时区名称

详细介绍

clockport

clockport 可以告诉你其他地方现在是什么时间，以及一个地点的给定时间对应另一个地点的什么时间。它可以通过命令行或作为面向 Agent 的 MCP 服务回答两个问题：“东京现在几点？”以及“我的电话会议定在纽约时间 12:00，伦敦时间是几点？”

所有时区处理都使用 Node Intl 支持背后的 IANA 时区数据库，因此夏令时变化由平台处理，而不是依赖固定的偏移量表。

安装

npx @reneturcios/clockport now Europe/London

或者运行容器镜像：

docker run -i ghcr.io/cloudcorprecords/clockport

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。

CLI

# Current time in a zone
clockport now America/New_York
# 2026-01-15 07:00:00 (America/New_York, 2026-01-15T07:00:00-05:00)

# Convert a time between zones
clockport convert America/New_York 12:00 Europe/London
# 2026-10-26 12:00 America/New_York -> 2026-10-26 17:00 Europe/London (+5h)

# Machine-readable output
clockport now Asia/Tokyo --json
clockport convert UTC 09:30 Asia/Kolkata --json

clockport --version

退出代码：成功时为 0；无法处理时区或时间时为 1（错误会指出问题）；用法错误时为 2。

MCP 服务

同一个可执行文件支持两种模式。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/clockport mcp

MCP 客户端配置：

{
  "mcpServers": {
    "clockport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/clockport", "mcp"]
    }
  }
}

工具

工具	输入	返回内容
`get_current_time`	`timezone`（字符串，必填）—— IANA 时区名称	该时区的当前时间：当地时钟显示时间、带偏移量的 ISO 8601 格式、星期、UTC 偏移量（分钟）以及是否处于夏令时。
`convert_time`	`source_timezone`（字符串，必填）、`time`（字符串，必填，24 小时制 `HH:MM`）、`target_timezone`（字符串，必填）	将所请求的时间转换为目标时区的显示时间，并返回目标日期（可能与源日期不同）、ISO 8601 格式以及带正负号的偏移量差值。

未知时区名称和无效的 HH:MM 时间会作为工具错误报告，而不会进行猜测。

转换的参考日期

convert_time 接受一天中的时间，但不接受日期。因此，转换会使用今天的日期作为参考，即源时区当前的日历日期。这在夏令时转换前后很重要，因为两个时区之间的偏移量差值可能每周都不同；结果始终反映今天生效的差值。每个转换结果都会包含所使用的参考日期。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network
npm run dev     # run the CLI from source via tsx