Time Server

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

Table of Contents

• Features

• Installation

• Usage

• API Documentation

• Development

• Contributing

• Code of Conduct

• License

Related MCP server: Interzoid Global Time API Server

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