# 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
```bash
npm install
```
## Development
Start the local development server:
```bash
npm run dev
```
The MCP server will be available locally for testing with MCP clients.
## Deployment
Deploy to Cloudflare Workers:
```bash
npm run deploy
```
### Custom Timezone Configuration
Override the default timezone during deployment:
```bash
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):
```json
{
"mcpServers": {
"time": {
"url": "https://your-worker.your-subdomain.workers.dev"
}
}
}
```
## Configuration
### wrangler.toml
The default timezone is configured in `wrangler.toml`:
```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](LICENSE) file for details
