Chuk MCP Time Server

🚀 MCP Time Server

The MCP Time Server is a powerful Python-based microservice offering advanced time-related utilities with multi - timezone support, enabling users to obtain the current time and perform time conversions across different global time zones.

🚀 Quick Start

The MCP Time Server is a Python - based microservice that provides advanced time - related utilities with support for multiple time zones. It offers powerful features for getting the current time and converting times between different global time zones.

Running the Server

Command - Line Interface

chuk-mcp-time-server

Programmatic Use

from chuk_mcp_time_server.main import main

if __name__ == "__main__":
    main()

✨ Features

• Current Time Retrieval: Get the current time in any IANA time zone.
• Time Zone Conversion: Convert times between different time zones.
• Comprehensive Validation: Use Pydantic models for robust input validation.
• Asynchronous Server Architecture: Achieve high - performance using asyncio.
• Flexible Configuration: Configure via environment variables and configuration files.

📦 Installation

Prerequisites

• Python 3.11 or higher
• pip
• (Optional) It is recommended to use a virtual environment.

Install from PyPI

pip install chuk-mcp-time-server

Install from Source Code

1. Clone the repository:

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

2. Create a virtual environment:

python -m venv venv
source venv/bin/activate  # Use `venv\Scripts\activate` on Windows

3. Install the package:

pip install .  # Install the package in editable mode

Development Installation

To set up for development:

pip install .[dev]  # Install the package with development dependencies

📚 Documentation

Project Details

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)

Environment Variables

• NO_BOOTSTRAP: Set this variable to disable component startup bootstrapping. Other configuration options can be set through the configuration file.

Available Tools

1. Get Current Time

Input:

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

Example:

get_current_time('Europe/London')

Return:

• The current time in the specified time zone.
• Time zone details.
• Daylight Saving Time (DST) status.

2. Convert Time

Input:

• source_timezone: Source time zone (in IANA format).
• time: Time in the format HH:MM (24 - hour clock).
• target_timezone: Target time zone (in IANA format).

Example:

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

Return:

• Source time details.
• Target time details.
• Time difference between the two time zones.

Development

Code Formatting

• Use Black for code formatting.
• Use isort for import sorting.
• Set the line length limit to 88 characters.

Run Tests

pytest

Contribution

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/AmazingFeature).
3. Ensure the code passes format checks and tests.
4. Commit changes (git commit -m 'Add some AmazingFeature').
5. Push to the branch (git push origin feature/AmazingFeature).
6. Open a Pull Request.

📄 License

MIT License