Chrishayuk Chuk MCP Time Server

🚀 MCP Time Server

MCP Time Server is an advanced Python-based microservice that offers cross-timezone time-related utilities. It provides powerful functions for retrieving the current time and converting time between different global time zones.

🚀 Quick Start

MCP Time Server is a powerful tool for handling time across different time zones. Here's how you can get started with it.

✨ Features

• Current Time Retrieval: Get the current time in any IANA timezone.
• Time Zone Conversion: Convert time between different time zones.
• Comprehensive Validation: Use Pydantic models for robust input validation.
• Asynchronous Server Architecture: Built with asyncio for efficient performance.
• Flexible Configuration: Configurable 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 the development environment:

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

💻 Usage Examples

Basic Usage

Run the Server via Command Line Interface

chuk-mcp-time-server

Run the Server Programmatically

from chuk_mcp_time_server.main import main

if __name__ == "__main__":
    main()

Advanced Usage

Get the Current Time

# Get the current time in a specific timezone
get_current_time('Europe/London')

Convert Time

# Convert time from one timezone to another
convert_time('America/New_York', '14:30', 'Europe/Paris')

📚 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 to disable component bootstrapping. Other configuration options can be set via the configuration file.

🔧 Technical Details

Code Formatting

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

Running Tests

pytest

🤝 Contributing

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

This project is licensed under the MIT License.