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_TIMEZONEenvironment variable - Final fallback: "Asia/Tokyo"
- If not provided, uses the
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.DateTimeFormatAPI - Validation: Zod schema validation
- CORS: Enabled with wildcard origin (
*)
License
MIT License - see LICENSE file for details