Time

🚀 Time MCP Server

A Model Context Protocol (MCP) server that provides time and timezone conversion functions. This server enables Large Language Models (LLMs) to obtain current time information, perform timezone conversions using IANA timezone names, and supports automatic detection of the system timezone.

🚀 Quick Start

The Time MCP Server allows LLMs to handle time and timezone-related tasks. It offers tools for getting the current time and converting time between different timezones.

✨ Features

Available Tools

• get_current_time - Get the current time in a specific timezone or the system timezone.

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

• convert_time - Convert time between different timezones.

  • Required parameters:
    • source_timezone (string): Source IANA timezone name
    • time (string): 24-hour time format (HH:MM)
    • target_timezone (string): Target IANA timezone name

📦 Installation

Using uv (Recommended)

When using uv, no specific installation is required. We'll directly use uvx to run mcp-server-time.

Using PIP

Alternatively, you can install mcp-server-time via pip:

pip install mcp-server-time

After installation, you can run it as a script:

python -m mcp_server_time

📚 Documentation

Configuration

Configuration for Claude.app

Add the following to your Claude settings:

Configuration for Local Development

Add the following to ~/.config/uv/servers.json:

{
  "servers": {
    "time": {
      "implementation": "local",
      "command": "node",
      "args": ["src/time/index.js"]
    }
  }
}

Example Questions

1. "What's the current time?" (Will use the system timezone)
2. "What time is it in Tokyo?"
3. "When it's 4 PM in New York, what time is it in London?"
4. "Convert 9:30 AM in Tokyo to New York time"

Development Build

Docker build:

cd src/time
docker build -t mcp/time .

🤝 Contribution

We welcome any contributions to help expand and improve mcp-server-time. Whether it's adding new time-related tools, enhancing existing features, or improving the documentation, your input is valuable.

For examples of other MCP servers and implementation patterns, see: https://github.com/modelcontextprotocol/servers

Pull Requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements to mcp-server-time to make it more powerful and useful.

📄 License

mcp-server-time is licensed under the MIT License. This means you're free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, see the LICENSE file in the project repository.