time-mcp
By samay58
GitHub
MCP server - make Claude tell the time! Highly reliable and consistent.
time-mcp
time-server
Overview
what is time-mcp?
Time-mcp is a server that provides real-time timezone-aware date and time information using the Claude Model Configuration Protocol (MCP).
how to use time-mcp?
To use time-mcp, clone the repository, set up a virtual environment, install the package, and run the server locally to make the time tool available to Claude.
key features of time-mcp?
- Get current time in any IANA timezone
- Easy integration with Claude AI through MCP
- Comprehensive timezone support using Python's zoneinfo module
- Simple JSON responses in ISO format
use cases of time-mcp?
- Providing real-time time information for applications that require timezone awareness.
- Integrating with AI systems to enhance their capabilities with accurate time data.
- Supporting developers in building applications that need reliable time information across different regions.
FAQ from time-mcp?
- What programming language is time-mcp built with?
Time-mcp is built using Python 3.10+.
- How can I get the current time in a specific timezone?
Use the
get_current_timetool with the desired IANA timezone as a parameter.
- Is there any license for using time-mcp?
Yes, time-mcp is licensed under the MIT License.
Content
time-mcp
A Claude Model Configuration Protocol (MCP) server that provides real-time timezone-aware date and time information.
Features
- Get current time in any IANA timezone
- Easy integration with Claude AI through MCP
- Comprehensive timezone support using Python's zoneinfo module
- Simple JSON responses in ISO format
Installation
# Clone the repository
git clone https://github.com/yourusername/time-mcp.git
cd time-mcp
# Set up virtual environment (using uv)
uv venv
source .venv/bin/activate
# Install the package
pip install -e .
Usage
Running the Server
python -m src.time_mcp.server
This starts the MCP server locally, making the time tool available to Claude.
Available Tools
get_current_time: Returns the current time in the specified timezone- Parameter:
timezone(string) - Any valid IANA timezone (e.g., "America/New_York", "Europe/London", "Asia/Tokyo") - Default: "UTC" if no timezone is specified
- Parameter:
Development
# Run tests
pytest tests/
# Lint code
ruff check .
# Format code
ruff format .
Requirements
- Python 3.10+
- MCP library
License
MIT
No tools information available.
