Skip to main content
Glama

MCP Time Server

by chrishayuk
MIT License
2

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
  1. Create a virtual environment:
python -m venv venv source venv/bin/activate # On Windows, use `venv\Scripts\activate`
  1. 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 (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

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

一个 Python 微服务,提供用于检索当前时间并在不同的全球时区之间进行转换的实用程序,并具有强大的验证功能。

  1. 概述
    1. 项目详情
      1. 特征
        1. 依赖项
          1. 安装
            1. 先决条件
            2. 从 PyPI 安装
            3. 从源安装
            4. 开发安装
          2. 运行服务器
            1. 命令行界面
            2. 程序化使用
          3. 环境变量
            1. 可用工具
              1. 1.获取当前时间
              2. 2. 转换时间
            2. 发展
              1. 代码格式化
              2. 运行测试
            3. 贡献
              1. 执照

                Related MCP Servers

                • -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server providing timezone conversions and time-related operations via RESTful API endpoints, featuring comprehensive error handling and timezone database integration.
                  Last updated -
                  Python
                • -
                  security
                  A
                  license
                  -
                  quality
                  A TypeScript server that provides time-related tools through the Model Context Protocol, allowing users to get current time in various timezones and convert times between different IANA timezones.
                  Last updated -
                  TypeScript
                  MIT License
                • -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server that allows users to get global time information via Interzoid's GetGlobalTime API, enabling access to time data across different regions through natural language.
                  Last updated -
                  Python
                • -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that provides the current time in any timezone with customizable formatting, allowing AI assistants to access accurate time information.
                  Last updated -
                  Python
                  MIT License

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/chrishayuk/chuk-mcp-time-server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server