Time

Provides a time service via get_current_time with IANA timezone support and automatic system timezone detection

python

1

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "taki-ta-mcp-server-time": {
      "command": "uvx",
      "args": [
        "mcp-server-time",
        "--local-timezone",
        "Asia/Shanghai"
      ]
    }
  }
}

You can use the Time MCP Server to query the current time in any IANA timezone. It provides a simple toolset for obtaining the system time or a time in a specified timezone, enabling you to render time-based logic for LLMs and other integrations with explicit timezone awareness.

How to use

You interact with the Time MCP Server through an MCP client by calling the available tool get_current_time and supplying a timezone name. The server returns the timezone, the current datetime in that zone, and whether daylight saving time is in effect.

How to install

Prerequisites: you will need Python for the pip installation, Docker if you want a container, and a runtime for the uv/uvx options.

# Install via uvx (recommended for runtime convenience)
# Ensure uvx is available in your environment and run the server using the local package
{"mcpServers": {"time": {"command": "uvx", "args": ["mcp-server-time", "--local-timezone", "Asia/Shanghai"]}}}

# Install via uv with a local directory
# Start the server from a local time source
{"mcpServers": {"time": {"command": "uv", "args": ["run", "--directory", "D:/WorkSpace/demo/servers/src/time", "mcp-server-time", "--local-timezone", "Asia/Shanghai"]}}}

# Run a Docker container with the Time MCP Server (no extra build steps needed here)
{"mcpServers": {"time": {"command": "docker", "args": ["run", "-i", "--rm", "mcp/time"]}}}

# Install via Python's pip and run as a module
pip install mcp-server-time
python -m mcp_server_time --local-timezone Asia/Shanghai

Additional installation paths for common environments

Configure your MCP client to the local Time MCP Server using one of the supported runtimes shown above. You can customize the timezone by adding the --local-timezone flag to the startup arguments.

Configuration notes

System timezone detection is automatic by default. Override it by supplying --local-timezone in the startup arguments, if you want to force a specific timezone.

Example Interactions

Ask for the current time using a specific timezone, for example: Asia/Shanghai.

Debugging

If you are debugging with an MCP inspector, use the inspector tool corresponding to your runtime to verify the server is reachable and returning correctly.

Build and runtime notes

If you deploy via Docker, you can build and run as shown in the install steps. For local testing, running with uvx/uv provides fast startup without a full rebuild.

Available tools

get_current_time

Get current time in a specific timezone or system timezone. Requires the argument timezone with a valid IANA timezone name.