Clockport

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Oct 29, 2026

Current time and timezone conversion for any IANA zone.

已驗證STDIO僅桌面位置與生活

概覽

AI 產生的概覽

Clockport 是本地 MCP 伺服器,讓助理查詢任一 IANA 時區的目前時間,並在時區之間換算時刻。

可以做什麼
  • 查詢指定 IANA 時區的目前時間,包含鐘面時間、帶偏移的 ISO 8601 形式、星期、UTC 偏移分鐘數與是否處於日光節約時間
  • 把某個時刻從來源時區換算到目標時區,回傳目標日期、ISO 8601 形式與帶正負號的偏移差
  • 遇到未知時區名稱或不合法的時刻時以工具錯誤回報,而不是自行猜測
  • 也可當作命令列工具使用,支援純文字或 JSON 輸出
適用情境
適合助理需要可靠的各地目前時間,或跨時區換算會議時間(包含日光節約時間差異)而不想自行推算的情況。
執行需求
以本機 stdio 程序執行,可透過 npx 從 npm 套件啟動,或以 docker 執行容器映像。未宣告任何帳號、API 金鑰、環境變數或請求標頭。時區資料來自平台透過 Node 的 Intl 支援的 IANA 資料庫。
安裝前請注意
換算只接受時刻、不含日期,因此以來源時區今天的日期作為參考日期;日光節約時間切換前後的結果反映的是今天生效的偏移,每次結果都會附上所用的參考日期。此伺服器為唯讀,且不需要任何憑證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Clockport,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

clockport

clockport tells you what time it is somewhere else, and what a given clock time in one place corresponds to in another. It answers two questions — "what time is it in Tokyo right now?" and "my call is at 12:00 New York time, what is that in London?" — from the command line or as an MCP server for agents.

All zone handling uses the IANA timezone database behind Node's Intl support, so daylight-saving changes are handled by the platform rather than by a fixed offset table.

Install

bash
npx @reneturcios/clockport now Europe/London

Or run the container image:

bash
docker run -i ghcr.io/cloudcorprecords/clockport

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

bash
# Current time in a zoneclockport now America/New_York# 2026-01-15 07:00:00 (America/New_York, 2026-01-15T07:00:00-05:00)
# Convert a time between zonesclockport 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 outputclockport now Asia/Tokyo --jsonclockport convert UTC 09:30 Asia/Kolkata --json
clockport --version

Exit codes: 0 on success, 1 when a zone or time cannot be handled (the error names the problem), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/clockport mcp

MCP client configuration:

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

Tools

ToolInputWhat it returns
get_current_timetimezone (string, required) — IANA timezone nameThe current time in that zone: wall-clock rendering, ISO 8601 form with offset, weekday, UTC offset in minutes, and whether DST is in effect.
convert_timesource_timezone (string, required), time (string, required, HH:MM 24-hour), target_timezone (string, required)The requested time rendered in the target zone, with the target date (which may differ from the source date), an ISO 8601 form, and the signed offset difference.

Unknown timezone names and times that are not valid HH:MM values are reported as tool errors rather than guessed at.

Reference date for conversions

convert_time takes a time of day but no date. Conversions therefore use today's date — the current calendar date in the source zone — as the reference date. This matters around daylight-saving transitions, where the offset difference between two zones can change from one week to the next; the result always reflects the difference in force today. The reference date used is included in every conversion result.

Development

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

License

MIT — see LICENSE.

來源:README.md,提交 0903cf2

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.0最新Oct 29, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分