Date MCP Server

現在時刻を提供するMCP (Model Context Protocol) サーバーです。AIエージェントが「最近の」「今の」などの時制を正しく理解できるよう、詳細な時刻情報を提供します。

機能

• 現在の日時を複数のフォーマットで提供
• タイムゾーンの変換をサポート
• 指定された日時と現在時刻の差を計算
• 詳細な時刻コンポーネント（年、月、日、時、分、秒など）を提供

インストール

npm install
npm run build

使用方法

開発モード

npm run dev

ビルド済みバージョンの実行

npm start

利用可能なツール

get_current_time

現在の日時を取得します。

パラメータ:

• timezone (オプション): タイムゾーン（例: "Asia/Tokyo", "America/New_York"）
• locale (オプション): ロケール（例: "ja-JP", "en-US"、デフォルト: "ja-JP"）

戻り値の例:

{
  "current": {
    "iso": "2025-07-09T10:30:00.000Z",
    "unix": 1741685400,
    "human": "2025年7月9日水曜日 19:30:00 日本標準時",
    "milliseconds": 1741685400000
  },
  "timezone": {
    "system": "Asia/Tokyo",
    "requested": "Asia/Tokyo",
    "offset": -540
  },
  "components": {
    "year": 2025,
    "month": 7,
    "day": 9,
    "hour": 19,
    "minute": 30,
    "second": 0,
    "dayOfWeek": 3,
    "weekOfYear": 28
  },
  "context": {
    "isWeekend": false,
    "quarter": 3,
    "dayOfYear": 190,
    "daysInMonth": 31
  }
}

calculate_date

現在または指定された日時から、指定された期間だけ前後の日時を計算します。

パラメータ:

• amount (必須): 加算・減算する数値（正の値で未来、負の値で過去）
• unit (必須): 時間の単位（"seconds", "minutes", "hours", "days", "weeks", "months", "years"）
• base_date (オプション): 基準となる日時（ISO 8601形式）。指定しない場合は現在時刻を使用
• locale (オプション): ロケール（例: "ja-JP", "en-US"、デフォルト: "ja-JP"）

使用例:

• 1日後: {"amount": 1, "unit": "days"}
• 3日前: {"amount": -3, "unit": "days"}
• 6時間後: {"amount": 6, "unit": "hours"}
• 2週後: {"amount": 2, "unit": "weeks"}
• 8年前: {"amount": -8, "unit": "years"}

get_time_difference

指定された日時と現在時刻の差を計算します。

パラメータ:

• target_date (必須): 比較対象の日時（ISO 8601形式）
• unit (オプション): 表示する単位（"seconds", "minutes", "hours", "days", "all"、デフォルト: "all"）

Claude Codeでの設定

Claude Codeの設定ファイルに以下を追加します:

{
  "mcpServers": {
    "date-mcp": {
      "command": "node",
      "args": ["/path/to/date-mcp/dist/index.js"]
    }
  }
}

ライセンス

MIT