Time MCP Server

A Model Context Protocol (MCP) server that provides current time information for specified timezones, built with Cloudflare Workers.

🌐 Live Demo

The server is deployed and ready to use:

• MCP Endpoint: https://time-mcp.radish2951.workers.dev/mcp

🛠️ Features

• Time Tool: Get current time in ISO format with day of week for any timezone
• Default Timezone: Japan Standard Time (Asia/Tokyo)
• Serverless: Runs on Cloudflare Workers with global edge deployment
• No Authentication: Public access for easy integration

📋 Available Tools

time_now

Returns the current time in ISO format with day of week for a specified timezone.

Parameters:

• tz (optional): IANA timezone string (e.g., "Asia/Tokyo", "America/New_York")
  • Default: "Asia/Tokyo"

Example Response:

{
  "iso": "2025-09-22T10:46:05.068",
  "tz": "Asia/Tokyo",
  "dayOfWeek": "Mon"
}

🚀 Quick Start

Test with MCP Inspector

1. Install and run MCP Inspector:

   npx @modelcontextprotocol/inspector@latest
   

2. Connect to the server:

   • Open the Inspector UI (usually http://localhost:5173)
   • Enter server URL: https://time-mcp.radish2951.workers.dev/mcp
   • Click "Connect"

3. Test the time_now tool with different timezones

Connect to Claude Desktop

To use this MCP server with Claude Desktop, add this configuration to your Claude Desktop settings:

1. Go to Settings > Developer > Edit Config
2. Add the following configuration:

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

3. Restart Claude Desktop

🔧 Local Development

Prerequisites

• Node.js 18+
• Cloudflare account (for deployment)

Setup

1. Clone the repository:

   git clone https://github.com/radish2951/time-mcp.git
   cd time-mcp
   

2. Install dependencies:

   npm install
   

3. Start local development server:

   npm start
   

4. The server will be available at http://localhost:8787/mcp

Deployment

1. Login to Cloudflare:

   npx wrangler login
   

2. Deploy to Cloudflare Workers:

   npx wrangler deploy
   

🏗️ Project Structure

src/
├── index.ts          # Main MCP server implementation
├── TimeMCP class     # MCP agent with time.now tool
└── Worker handler    # Cloudflare Workers request handler

🌍 Supported Timezones

Any valid IANA timezone identifier is supported, including:

• Asia/Tokyo (JST - Default)
• America/New_York (EST/EDT)
• Europe/London (GMT/BST)
• UTC (Coordinated Universal Time)
• Asia/Shanghai (CST)
• And many more...

📝 License

This project is open source and available under the MIT License.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🔗 Links

• Model Context Protocol
• Cloudflare Workers
• MCP Inspector