Time Server

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.

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

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
          1. Manual Installation
          2. Usage
            1. API Documentation
              1. Tools
                1. get_current_time
                  1. convert_time
                2. Development
                  1. Code of Conduct
                    1. License