remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Includes component bootstrapping functionality that can be disabled via the NO_BOOTSTRAP environment variable
Supports development workflows through Git with contribution guidelines for feature branches and pull requests
Utilizes Pydantic for robust input validation using Pydantic models to ensure data integrity for time-related operations

MCP Time Server

Overview

The MCP Time Server is a sophisticated Python-based microservice designed to provide advanced time-related utilities across different timezones. It offers robust functionality for retrieving current times and converting times between various global timezones.

Project Details

Version: 0.1.1
Python Compatibility: Python 3.11+

Features

Current Time Retrieval: Get the current time for any IANA timezone
Time Zone Conversion: Convert times between different time zones
Comprehensive Validation: Robust input validation using Pydantic models
Async Server Architecture: Built with asyncio for efficient performance
Flexible Configuration: Configurable through environment variables and config files

Dependencies

Core dependencies:

mcp (>=1.6.0)
pydantic (>=2.11.2)
PyYAML (>=6.0.2)
pyz (>=0.4.3)

Development dependencies:

pytest (>=8.3.5)

Installation

Prerequisites

Python 3.11 or higher
pip
(Optional) Virtual environment recommended

Install from PyPI

pip install chuk-mcp-time-server

Install from Source

Clone the repository:

git clone <repository-url>
cd chuk-mcp-time-server

Create a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

Install the package:

pip install .  # Installs the package in editable mode

Development Installation

To set up for development:

pip install .[dev]  # Installs package with development dependencies

Running the Server

Command-Line Interface

chuk-mcp-time-server

Programmatic Usage

from chuk_mcp_time_server.main import main

if __name__ == "__main__":
    main()

Environment Variables

NO_BOOTSTRAP: Set to disable component bootstrapping
Other configuration options can be set in the configuration files

Available Tools

1. Get Current Time

Input:

timezone: IANA timezone name (e.g., 'America/New_York')

Example:

get_current_time('Europe/London')

Returns:

Current time in the specified timezone
Timezone details
Daylight Saving Time (DST) status

2. Convert Time

Input:

source_timezone: Source timezone (IANA format)
time: Time in HH:MM (24-hour) format
target_timezone: Target timezone (IANA format)

Example:

convert_time('America/New_York', '14:30', 'Europe/Paris')

Returns:

Source time details
Target time details
Time difference between zones

Development

Code Formatting

Black is used for code formatting
isort is used for import sorting
Line length is set to 88 characters

Running Tests

pytest

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Ensure code passes formatting and testing
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

License

MIT License

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

A Python microservice that provides utilities for retrieving current times and converting between different global timezones with robust validation.

Related Resources

Reddit Discussion about this server