MCP Time Server

Provides time utilities to retrieve current times and convert times between IANA timezones for MCP clients.

python

4

GitHub Stars

python

Language

6 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": {
    "chrishayuk-chuk-mcp-time-server": {
      "command": "chuk-mcp-artifact-server",
      "args": [],
      "env": {
        "NO_BOOTSTRAP": "true"
      }
    }
  }
}

You can run the MCP Time Server to get current times in any IANA timezone and to convert times between zones. This lightweight Python-based MCP service is useful for applications that need accurate time information across multiple regions without building time logic from scratch.

How to use

Use the MCP client to access two core capabilities: 1) Get the current time for a specific IANA timezone, and 2) Convert a time from one timezone to another. You can request the current time in a given timezone to display local time, DST status, and timezone details. You can also provide a time and source/target timezones to obtain the corresponding time in the target zone, along with the time difference between zones.

How to install

Prerequisites you need before installation: Python 3.11 or higher and pip.

pip install chuk-mcp-artifact-server

If you are installing from source, follow these steps to set up a development environment and install the package in editable mode.

git clone <repository-url>
cd chuk-mcp-artifact-server

python -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

pip install .  # Installs the package in editable mode

If you want to set up for development with extra dependencies, run the following.

pip install .[dev]  # Installs package with development dependencies

Running the server

To start the server, you can run the MCP artifact server CLI from your environment.

chuk-mcp-artifact-server

Environment and startup notes

You can disable automatic bootstrapping of components by setting the environment variable NO_BOOTSTRAP. Other configuration options can be provided through config files as needed.

Available tools

get_current_time

Retrieves the current time for a specified IANA timezone and returns timezone details and DST status.

convert_time

Converts a given time from a source timezone to a target timezone and returns source/target details along with the time difference.