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

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!