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

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