clockport

clockport

clockport は、別の場所の現在時刻や、ある場所の指定時刻が別の場所では何時に当たるかを教えてくれます。「今、東京は何時ですか？」と「ニューヨーク時間で12:00に通話があるのですが、ロンドンでは何時ですか？」という2つの質問に、コマンドラインから、またはエージェント向けの MCP サーバーとして回答します。

タイムゾーンの処理にはすべて、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 サーバー

1つの実行ファイルで、どちらの使い方にも対応します。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 では時刻のみを指定し、日付は指定しません。そのため、変換には今日の日付、つまり変換元のタイムゾーンにおける現在の暦日を基準日として使用します。これは夏時間の切り替わり前後に重要です。2つのタイムゾーン間の時差は週によって変わる場合があり、結果には常に今日有効な時差が反映されます。使用した基準日は、すべての変換結果に含まれます。

開発

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

ライセンス

MIT — LICENSE を参照してください。