MCP Simple Timeserver

MCP Simple Timeserver

Anthropicが行った奇妙な設計上の決定の一つに、claude.aiでユーザーが送信したメッセージのタイムスタンプや、一般的な現在時刻をClaudeに提供しないことがあります。かわいそうなClaudeは、今何時なのか分かりません！ mcp-simple-timeserverは、それを解決するシンプルなMCP サーバーです。

利用可能なツール

このサーバーでは、以下のツールを利用できます。

ツール	説明
get_local_time	ユーザーのマシンの現在のローカル時刻、曜日、タイムゾーンを返します
get_utc	NTPタイムサーバーから正確なUTC時刻を返します
get_current_time	場所、タイムゾーン、暦の変換をオプションで指定して、現在時刻を返します
calculate_time_distance	2つの日付／時刻の間の期間（カウントダウン、経過時間）を計算します
get_holidays	国の祝日（およびオプションで学校休業日）を返します
is_holiday	指定された国または都市で、特定の日付が祝日かどうかを確認します

get_local_timeを除くすべてのツールは、NTPサーバーから取得した正確な時刻を使用します。NTPが利用できない場合は、その旨を通知したうえで、ローカルサーバーの時刻に適切にフォールバックします。

get_current_timeによる場所のサポート

get_current_timeツールでは、場所のパラメーターを指定して、世界中の任意の場所の現地時刻を取得できます。

パラメーター	説明	例
city	都市名（主な用途）	"Warsaw"、"Tokyo"、"New York"
country	国名またはISOコード	"Poland"、"JP"、"United States"
timezone	IANAタイムゾーンまたはUTCオフセット	"Europe/Warsaw"、"+05:30"

優先順位：timezone > city > country。場所を指定すると、応答には現地時刻、タイムゾーン情報、UTCオフセット、夏時間の適用状況が含まれます。

指定した場所が今日祝日の場合、その情報が出力に表示されます。

get_current_timeによる暦のサポート

get_current_timeツールでは、カンマ区切りの暦形式のリストを指定する、任意のcalendarパラメーターも受け付けます。

暦	説明
unix	Unixタイムスタンプ（1970-01-01からの秒数）
isodate	ISO 8601週日付（例：2026-W03-6）
hijri	イスラム暦／ヒジュラ暦
japanese	和暦（英語と漢字の両方を返します）
hebrew	ヘブライ暦／ユダヤ暦（英語とヘブライ語の両方を返し、祝日を含みます）
persian	ペルシア暦／ジャラリ暦（英語とペルシア語の両方を返します）

例：get_current_time(city="Tokyo", calendar="japanese")は、東京の現地時刻と和暦を返します。

calculate_time_distance による時間差の計算

2つの日付または時刻の間の期間を計算します。

パラメーター	説明	例
from_date	開始日（ISO 8601 または "now"）	"2025-01-15"、"now"
to_date	終了日（ISO 8601 または "now"）	"2025-12-31"、"2025-06-01T17:00:00"
unit	出力形式	"auto"、"days"、"weeks"、"hours"、"minutes"、"seconds"
business_days	月曜から金曜のみをカウントします（日付ベース、両端を含む）	true
exclude_holidays	祝日も除外します（国／都市が必要です）	true

タイムゾーンのコンテキストを指定するために、位置情報のパラメーター（city、country、timezone）も使用できます。

business_days=true の場合、時刻は無視され、日付は丸1日としてカウントされます（両端を含む）。 このモードでは unit パラメーターは無視されます。祝日は平日にあたる場合のみ除外されます。

例：calculate_time_distance(from_date="now", to_date="2025-12-31") は、大晦日までのカウントダウンを返します。 例：calculate_time_distance(from_date="2026-01-26", to_date="2026-01-30", business_days=true, exclude_holidays=true, city="Sydney") は、その期間の営業日数を返します。

get_holidays と is_holiday による祝日情報

約119か国の祝日と学校の休暇情報を取得します。

get_holidays のパラメーター：

パラメーター	説明	例
country	国名または ISO コード（必須）	"Poland"、"DE"、"United States"
year	祝日を取得する年（デフォルト：現在の年）	2026
include_school_holidays	学校の休暇期間を含めます	true

is_holiday のパラメーター：

パラメーター	説明	例
country	国名または ISO コード	"Poland"、"US"
city	地域ごとの情報を取得する都市名	"Warsaw"、"Munich"
date	ISO 形式で確認する日付（デフォルト：今日）	"2026-01-01"

地域別の学校休暇：is_holiday で city パラメーターを使用すると、学校の休暇情報は指定した地域に該当するものだけに絞り込まれます。これは、地域によって学校の休暇期間が異なる国（例：ポーランドの県、ドイツの州、スペインの自治州）で特に便利です。

例：is_holiday(city="Warsaw", date="2026-01-19") は、マゾフシェ県に固有の学校休暇情報を返します。

データソース：

• 祝日：Nager.Date API（119か国）
• 学校の休暇：OpenHolidaysAPI（36か国、主にヨーロッパ）

インストール

Smithery 経由でのインストール

Smithery 経由で Claude Desktop に Simple Timeserver を自動的にインストールするには：

npx -y @smithery/cli install mcp-simple-timeserver --client claude

手動インストール

まず、次のコマンドでモジュールをインストールします。

pip install mcp-simple-timeserver

次に、MCP クライアント（Claude desktop app）で設定します。

Mac OS では、次のようになります。

"mcpServers": {
  "simple-timeserver": {
    "command": "python",
    "args": ["-m", "mcp_simple_timeserver"]
  }
}

Windows では、cmd（Windows のコマンドライン）で where python を実行して、Python 実行ファイルへのパスを確認してください。

一般的な設定は次のようになります。

"mcpServers": {
  "simple-timeserver": {
    "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
    "args": ["-m", "mcp_simple_timeserver"]
  }
}

Web サーバー版

このプロジェクトには、スタンドアロンの Web サーバーとしてデプロイできる、ネットワーク上でホスト可能なバージョンも含まれています。実行方法とデプロイ方法については、Web サーバーのデプロイガイドをご覧ください。

または、MCP に対応する Claude などのツールに https://mcp.andybrandt.net/timeserver を追加して、私のサーバーをそのまま使用することもできます。