time

mcp-time-tools

Model Context Protocol（MCP）を介して AI エージェント向けに日付、時刻、タイムゾーンのツールを提供します。

ネイティブの JavaScript Date および Intl API のみで構築されており、外部の日付ライブラリは不要です。

ツール

タイムゾーン変換

• convert_timezone -- 日時をあるタイムゾーンから別のタイムゾーンに変換します
• list_timezones -- 現在の UTC オフセットとともによく使われるタイムゾーンを一覧表示します
• current_time_multi -- 複数のタイムゾーンの現在時刻を一度に表示します
• time_difference -- 2 つのタイムゾーン間の時差を計算します

日付計算

• date_add_subtract -- 日付に日、週、月、年を加算または減算します
• date_difference -- さまざまな単位で 2 つの日付の差を計算します
• 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 -- 秒数を人間が読みやすい時間表記に変換します（例：2h 30m 15s）
• 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