日時ツール MCP

日時操作およびタイムゾーン変換のためのModel Context Protocol (MCP) サーバーです。

概要

このMCPサーバーは、タイムゾーン変換、日付の変更（算術演算）、現在の日時とタイムゾーンの取得など、日時文字列を扱うための一連のツールを提供します。堅牢で標準化された日時操作を必要とするアプリケーションやエージェントのバックエンドユーティリティとして設計されています。

ライブデプロイ: https://date-time-tools.iabhishek.workers.dev/mcp

Related MCP server: Time MCP Server

アーキテクチャ

このサーバーは Cloudflare Workers 上で動作し、Streamable HTTP トランスポート（レガシーなSSEエンドポイントも公開）を使用します。セッションごとの状態は、Cloudflareの agents McpAgent ラッパーを介してDurable Objectによってバックアップされます。

エンドポイント:

• POST/GET/DELETE /mcp — Streamable HTTPトランスポート。セッションは mcp-session-id ヘッダーで追跡されます。

• GET /sse, POST /sse/message — 古いクライアント用のレガシーSSEトランスポート。

ローカル開発

npm install
npm run dev   # wrangler dev — serves at http://127.0.0.1:8787/mcp

Cloudflareへのデプロイ

手動

初回セットアップ:

npx wrangler login

デプロイ:

npm run deploy

Wranglerが公開URLを表示します。このプロジェクトの場合は https://date-time-tools.iabhishek.workers.dev/mcp です。Workersの無料プランでこのサーバーをカバーできます（1日10万リクエストまで。Durable Objectsの無料枠でセッションストレージをカバー）。

自動化 (GitHub Actions)

.github/workflows/deploy.yml は、main へのプッシュごと（および手動の workflow_dispatch）にデプロイを行います。2つのリポジトリシークレットを設定してください:

• CLOUDFLARE_API_TOKEN — https://dash.cloudflare.com/profile/api-tokens にて Edit Cloudflare Workers テンプレートを使用して作成

• CLOUDFLARE_ACCOUNT_ID — Workers & Pagesダッシュボードのサイドバーで確認可能

MCPクライアントとの統合

Claude Code

claude mcp add date-time-tools --transport http https://date-time-tools.iabhishek.workers.dev/mcp

すべてのプロジェクトに登録するには --scope user を追加し、共同作業者と共有する .mcp.json をコミットするには --scope project を追加します。claude mcp list で確認してください。Claude Code内では /mcp を実行してステータスとツールを検査します。

汎用Streamable HTTPクライアント

Streamable HTTPトランスポートをサポートするクライアントを設定し、デプロイされたURLを指定します:

{
  "mcpServers": {
    "date-time-tools": {
      "url": "https://date-time-tools.iabhishek.workers.dev/mcp"
    }
  }
}

stdioのみをサポートするクライアントの場合は、mcp-remote でブリッジします:

{
  "mcpServers": {
    "date-time-tools": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://date-time-tools.iabhishek.workers.dev/mcp"]
    }
  }
}

利用可能なツール

このMCPサーバーは、LLM向けに以下のツールを提供します:

• convertTimezones: 日時文字列をあるタイムゾーンから別のタイムゾーンへ変換します。

• mutateDate: 日時文字列に対して、日、時間、分、月、または年を加算または減算します。

• currentDateTimeAndTimezone: 現在の日付、時刻、タイムゾーンを取得します。

🧪 MCP Inspectorによるテスト

npm run dev を実行し、別のターミナルで以下を実行します:

npx -y @modelcontextprotocol/inspector

Streamable HTTP トランスポートを選択し、URLとして http://127.0.0.1:8787/mcp を使用します。

機能

• タイムゾーン変換
  Luxon互換の形式を使用して、日時文字列をあるIANAタイムゾーンから別のタイムゾーンへ変換します。

• 日付の変更
  日時文字列に対して、日、時間、分、月、または年を加算または減算します。

• 現在の日時とタイムゾーン
  ユーザー/システムの現在の日付、時刻、タイムゾーンを取得します。