Time Server
About
Time Server is an MCP (Model Context Protocol) server that provides timezone conversions and time-related operations. It is built with MCP protocol standards and offers tools to get current time in any timezone and convert time between timezones. It targets developers and AI…
Explore
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Time ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Start the server:
python -m time_server
To install Time Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @clssck/mcp-time-server --client claude
pip install .
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"time server": {
"clssck_mcp-time-server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@clssck/mcp-time-server",
"--client",
"claude"
]
}
}
}
}McpServers
{
"clssck_mcp-time-server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@clssck/mcp-time-server",
"--client",
"claude"
]
}
}
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
