mcp-time-worker

A Cloudflare Workers-based MCP (Model Context Protocol) server that provides timezone-aware time information.

Features

• Returns current date and time in any IANA timezone
• Runs on Cloudflare's global edge network
• Implements the Model Context Protocol for AI agent integration
• Configurable default timezone via environment variables
• ISO 8601-compatible time format with UTC offset

Prerequisites

• Node.js 18 or later
• Cloudflare account (for deployment)
• Wrangler CLI (installed via npm)

Installation

npm install

Development

Start the local development server:

npm run dev

The MCP server will be available locally for testing with MCP clients.

Deployment

Deploy to Cloudflare Workers:

npm run deploy

Custom Timezone Configuration

Override the default timezone during deployment:

wrangler deploy --var DEFAULT_TIMEZONE:America/New_York

Or set it in the Cloudflare dashboard under Workers > Settings > Environment Variables.

Usage

This MCP server exposes a single tool that can be called by any MCP client:

Tool: get_time

Returns the current date and time in a specified timezone.

Parameters:

• timezone (optional): IANA timezone identifier (e.g., "Asia/Tokyo", "America/New_York", "Europe/London")
  • If not provided, uses the DEFAULT_TIMEZONE environment variable
  • Final fallback: "Asia/Tokyo"

Response Format:

YYYY-MM-DDTHH:MM:SS±HH:MM

Example: 2025-11-27T15:30:45+09:00

Example MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "time": {
      "url": "https://your-worker.your-subdomain.workers.dev"
    }
  }
}

Configuration

wrangler.toml

The default timezone is configured in wrangler.toml:

[vars]
DEFAULT_TIMEZONE = "Asia/Tokyo"

Modify this value to change the default timezone for your deployment.

Technical Details

• Runtime: Cloudflare Workers (Edge)
• Protocol: Model Context Protocol (MCP)
• Timezone Library: Native Intl.DateTimeFormat API
• Validation: Zod schema validation
• CORS: Enabled with wildcard origin (*)

License

MIT License - see LICENSE file for details