Time MCP Server

🚀 Time MCP Server

A Model Context Protocol server that provides time and timezone conversion functions. This server enables LLMs to obtain current time information and perform timezone conversions using IANA timezone names, with support for automatic system timezone detection.

🚀 Quick Start

This Time MCP Server offers time and timezone conversion functionalities, allowing LLMs to access current time details and perform timezone conversions.

✨ Features

• Time Retrieval: Use the get_current_time tool to obtain the current time in a specific or system timezone.
• Time Conversion: Employ the convert_time tool to convert time between different timezones.
• Automatic Timezone Detection: Automatically detect the system timezone if no specific timezone is provided.

📦 Installation

Recommended: Using uv

cd path/to/server/time
uv run mcp-time

Alternative: Installing via pip

pip install time-mcp-server
time-mcp-server

💻 Usage Examples

Basic Usage

Example Questions

1. "What time is it?" (Using the system timezone)
2. "What time is it in Tokyo?"
3. "What time is it in London when it's 4 PM in New York?"
4. "Convert 9:30 AM in Tokyo to New York time"

Tools and Parameters

• get_current_time:

  • Required Parameter:
    • timezone (string): IANA timezone name (e.g., 'America/New_York', 'Europe/London')

• convert_time:

  • Required Parameters:
    • source_timezone (string): Source IANA timezone name
    • time (string): 24-hour format (e.g., 'HH:MM')
    • destination_timezone (string): Destination IANA timezone name

📚 Documentation

Configuration Guide

For Claude.app

1. Add the server folder to the src directory.
2. Register the timezone tool in server.json:

{
  "tools": {
    "mcp-time": {
      "path": "time/src/server.ts"
    }
  }
}

For Zee

1. Add the server folder to the src directory.
2. Register the timezone tool in server.json:

{
  "tools": {
    "mcp-time": {
      "path": "time/src/server.ts"
    }
  }
}

Custom Settings

You can specify the local timezone in the configuration. By default, the system timezone is automatically detected.

Debugging

Use the MCP inspector for debugging. Follow the instructions in the documentation to navigate to the relevant directory and run the server for debugging checks.

Building

Execute the following command inside the server folder:

docker build -t mcp/time .

🤝 Contribution Guidelines

Contributions to mcp-server-time are welcome! Whether it's adding new features, fixing issues, or improving the documentation, your involvement is highly appreciated. For implementation patterns of other MCP servers, refer to the relevant project links.

📄 License

mcp-server-time is licensed under the MIT License, which permits free use, modification, and distribution of the software. For detailed license information, please refer to the LICENSE file in the project repository.