time-mcp

radish2951/time-mcp

3.2

If you are the rightful owner of time-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Time MCP Server is a Model Context Protocol server that provides current time information for specified timezones, utilizing Cloudflare Workers for deployment.

Tools
1
Resources
0
Prompts
0

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"
      ]
    }
  }
}
  1. 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