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 formatfrom_timezone: string - Source timezoneto_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