# 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:**
```json
{
  "iso": "2025-09-22T10:46:05.068",
  "tz": "Asia/Tokyo",
  "dayOfWeek": "Mon"
}
```

## 🚀 Quick Start

### Test with MCP Inspector

1. Install and run MCP Inspector:
   ```bash
   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:

```json
{
  "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:
   ```bash
   git clone https://github.com/radish2951/time-mcp.git
   cd time-mcp
   ```

2. Install dependencies:
   ```bash
   npm install
   ```

3. Start local development server:
   ```bash
   npm start
   ```

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

### Deployment

1. Login to Cloudflare:
   ```bash
   npx wrangler login
   ```

2. Deploy to Cloudflare Workers:
   ```bash
   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](https://modelcontextprotocol.io/)
- [Cloudflare Workers](https://workers.cloudflare.com/)
- [MCP Inspector](https://github.com/modelcontextprotocol/inspector)