mcp-time

The MCP Time server provides a timezone-aware time service built around the IANA timezone database. It runs as a Python module, exposing a clean, asynchronous interface for retrieving current times in various time zones and performing related conversions. To start the server, run the CLI entry point provided by the package: python -m mcp_time_server. This launches the time service and makes its capabilities available to MCP clients that implement the Model Context Protocol. Typical usage involves querying for the current time in a specified IANA timezone, along with appropriate error handling if an invalid timezone is requested. The server is designed to be robust across platforms and ships with bundled tzdata for reliable timezone data even in minimal environments.

Prerequisites:

• Python (3.8+ recommended)
• pip (comes with Python)

Install the MCP Time server from PyPI:

pip install mcp-time-server

Run the server (examples):

python -m mcp_time_server

Optional development workflow (if you plan to contribute):

pip install -e ".[dev]"
pytest

You can verify installation by listing the package and ensuring the entry point works, then start the server as shown above.

Notes and tips:

• The server includes an IANA timezone database and bundled tzdata for reliable operation across environments.
• If your deployment defines TZ or other environment variables, ensure they are compatible with Python's timezone handling.
• If you encounter timezone lookup issues, verify that the IANA database is accessible and that the Python environment has the necessary permissions.
• For testing, run the included test suite with pytest after installing development dependencies.
• This server is designed to be asynchronous and High-Performance with async/await usage in handlers.