What is Chuk Mcp Time Server

The chuk-mcp-time-server is a Python-based microservice that provides advanced time-related utilities, including current time retrieval and timezone conversion across various global timezones.

Use cases

Use cases include retrieving the current time for different locations, converting meeting times across time zones for international teams, and validating time inputs in applications.

How to use

To use chuk-mcp-time-server, install it via pip with ‘pip install chuk-mcp-time-server’, then run it using the command line or programmatically by importing the main function from the package.

Key features

Key features include current time retrieval for any IANA timezone, time zone conversion, comprehensive input validation with Pydantic, an async server architecture for efficient performance, and flexible configuration options.

Where to use

chuk-mcp-time-server can be used in applications requiring accurate time management across different time zones, such as scheduling systems, global communication platforms, and any service that needs to handle time-sensitive data.

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-artifact-server

Install from Source

1. Clone the repository:

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

2. Create a virtual environment:

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

3. 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-artifact-server

Programmatic Usage

from chuk_mcp_artifact_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

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Ensure code passes formatting and testing
4. Commit your 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