Time Tools Mcp Server

時刻操作用 MCP サーバー

時刻操作用の動的な MCP サーバー管理サービスです。

MCP ツール

このサーバーは、Model Context Protocol（MCP）を通じて、時刻関連のツールをいくつか提供します。

---

get_timezone

サーバーの現在のタイムゾーンを取得します。

• 戻り値:
  • text: タイムゾーン文字列。
    • 例：Asia/Tokyo

---

get_unixtime

現在の Unix タイムスタンプ（エポックからの秒数）を取得します。

• 戻り値:
  • text: 文字列形式の Unix タイムスタンプ。
    • 例：1746627290

---

convert_unix_to_datetime

Unix タイムスタンプを、書式設定された日時文字列に変換します。

• パラメーター:

  • unixtime（number、必須）：変換する Unix タイムスタンプ。
    • 例：1746627290
  • timezone（string、任意）：使用するタイムゾーン（デフォルト：サーバーのタイムゾーン）。
    • 例：Asia/Tokyo
  • isISO（boolean、任意）：true の場合は ISO 8601 形式を返し、それ以外の場合は YYYY-MM-DD HH:mm:ss を返します。
    • 例：true

• 戻り値:

  • text: 書式設定された日時文字列。
    • 例：2025-01-01 01:01:01 または 2025-01-01T01:01:01+09:00

---

convert_datetime_to_unix

日時文字列を Unix タイムスタンプ（エポックからのミリ秒数）に変換します。

• パラメーター:

  • time（string、必須）：変換する日時文字列。
    • 例：2025-01-01 01:01:01
  • timezone（string、任意）：使用するタイムゾーン（デフォルト：サーバーのタイムゾーン）。
    • 例：Asia/Tokyo

• 戻り値:

  • text: 文字列形式の Unix タイムスタンプ。
    • 例：1746627290000

---

get_current_date_time

現在の日付と時刻を YYYY-MM-DD HH:mm:ss 形式で取得します。

• パラメーター:

  • timezone（string、任意）：使用するタイムゾーン（デフォルト：サーバーのタイムゾーン）。
    • 例：Asia/Tokyo

• 戻り値:

  • text: 書式設定された現在の日付と時刻。
    • 例：2025-01-01 01:01:01

---

get_current_date_time_iso

現在の日付と時刻を ISO 8601 形式で取得します。

• パラメーター:

  • timezone（string、任意）：使用するタイムゾーン（デフォルト：サーバーのタイムゾーン）。
    • 例：Asia/Tokyo

• 戻り値:

  • text: ISO 8601 形式で書式設定された現在の日付と時刻。
    • 例：2025-05-07T23:03:27+09:00

---

get_elapsed_time

2 つの日時文字列の差を計算します。

• パラメーター:

  • from（string、必須）：開始日時。
    • 例：2025-01-01 01:01:01
  • to（string、必須）：終了日時。
    • 例：2025-01-02 02:02:02
  • unit（"millisecond" | "second" | "minute" | "hour" | "day" | "week" | "month" | "year"、任意、デフォルト："second"）：差を表す単位。
    • 例："hour"

• 戻り値:

  • text: 指定した単位での 2 つの日時の差。
    • 例：3600

MCP サーバーアプリの準備

1. パッケージをインストールする

pnpm install

2. ビルドする

pnpm build

MCP Inspector

Inspector - Model Context Protocol

pnpm inspect

get_current_date_time

get_elapsed_time

VS Code

プロジェクトで管理する場合

.vscode/mcp.json

{
  "servers": {
    "time-tools": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/build/index.js"]
    }
  }
}

個人用のグローバル管理の場合

~/Library/Application Support/Code/User/settings.json

{
  "mcp": {
    "servers": {
      "time-tools": {
        "command": "node",
        "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/build/index.js"]
      }
    }
  }
}

プロンプトの例

英語

## Overview
- Please perform the following tasks
- Perform the following tasks and measure the time it takes to perform the tasks.
- Please follow the time tracking requirements for the measurement method

## Tasks
- Create the src directory
- Create an empty file in it
- Name the file index.ts

## Time tracking requirements
1. retrieve and display the current time before the task starts 2.
2. retrieve and display the current time after the task is completed 3.
3. retrieve and display the elapsed time from the start and end time of the task 4. finally display the following table
4. finally display in the following table format 
|item|record| 
|:---|:---| 
|start time|<enter result>| 
|end time|<enter result>| 
|elapsed time|<enter result>|

日本語

## 概要
- 以下のタスクを実行してください
- タスク実行に要した時間も計測します
- 計測の方法はタイムトラッキング要件にしたがってください

## タスク
- src ディレクトリを作成する
- その中に空のファイルを作成する
- 作成するファイル名は index.ts とする

## タイムトラッキング要件
1. タスク開始前の現在時間を取得して表示する
2. タスク終了後の現在時間を取得して表示する
3. タスクの開始時と終了時の時間から経過時間を取得して表示する
4. 最終的に以下の表形式で表示してください
|項目|記録|
|:---|:---|
|開始時間|<結果を入力>|
|終了時間|<結果を入力>|
|経過時間|<結果を入力>|