Time Server

by clssck

Integrations

  • Adheres to the Contributor Covenant code of conduct for project participation and contribution guidelines.

  • Uses Pytest for running tests on the time server implementation.

  • Built with Python 3.10+, providing a type-safe implementation for time-related operations.

Time Server

An MCP server for timezone conversions and time-related operations, built with the Model Context Protocol standards.

Table of Contents

Features

  • Get current time in any timezone
  • Convert time between timezones
  • Built with MCP protocol standards
  • Type-safe Python implementation
  • RESTful API endpoints
  • Comprehensive error handling
  • Timezone database integration

Installation

Installing via Smithery

To install Time Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @clssck/mcp-time-server --client claude

Manual Installation

pip install .

Usage

Start the server:

python -m time_server

API Documentation

Tools

get_current_time

Get current time in a specific timezone

Parameters:

  • timezone: string - IANA timezone identifier (e.g. "America/New_York")

Returns:

  • Current time in ISO 8601 format
convert_time

Convert time between timezones

Parameters:

  • time: string - Time to convert in ISO 8601 format
  • from_timezone: string - Source timezone
  • to_timezone: string - Target timezone

Returns:

  • Converted time in ISO 8601 format

Development

Install development dependencies:

pip install -e .[dev]

Run tests:

pytest

Check code quality:

ruff check . mypy src

Code of Conduct

This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code.

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server providing timezone conversions and time-related operations via RESTful API endpoints, featuring comprehensive error handling and timezone database integration.

  1. Table of Contents
    1. Features
      1. Installation
        1. Installing via Smithery
        2. Manual Installation
      2. Usage
        1. API Documentation
          1. Tools
        2. Development
          1. Code of Conduct
            1. License

              Related MCP Servers

              • -
                security
                A
                license
                -
                quality
                An MCP server that allows checking local time on the client machine or current UTC time from an NTP server
                Last updated -
                14
                Python
                MIT License
                • Apple
              • A
                security
                A
                license
                A
                quality
                A TypeScript server implementing the Model Context Protocol (MCP) that provides datetime and timezone information to AI agents and chat interfaces, allowing them to access current time in various timezones.
                Last updated -
                4
                2
                TypeScript
                Mozilla Public License 2.0
              • A
                security
                F
                license
                A
                quality
                A Model Context Protocol server that provides time and timezone conversion capabilities, enabling LLMs to get current time information and perform timezone conversions using IANA timezone names.
                Last updated -
                2
                1
                Python
              • -
                security
                A
                license
                -
                quality
                A lightweight mcp server that tells you exactly what time is it based on your IP.
                Last updated -
                3
                Python
                MIT License

              View all related MCP servers

              ID: lo6ocr3732