Time Server logo

Time Server

by MCP-Mirror

An MCP server for timezone conversions and time-related operations, built with the Model Context Protocol standards. It allows users to get the current time in any timezone and convert time between timezones.

View on GitHub

Last updated: N/A

Time Server

MCP

MCP

Python

Python

License

License

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