Skip to main content

An MCP Server that provides a tool to get the current time with optional timezone support

Project description

MCP Time Server

An MCP Server that provides a tool to get the current time with optional timezone support.

Features

  • Provides a get_current_time tool to retrieve the current time
  • Supports optional timezone parameter
  • Simple and lightweight implementation
  • Built using the Model Context Protocol (MCP)

Installation

pip install mcp-time-server

Usage

Running the Server

mcp-time-server

This will start the MCP Server using the STDIO transport, which is suitable for local process communication.

Using the get_current_time Tool

The server exposes a single tool called get_current_time that can be used by MCP clients.

Parameters

  • timezone (optional): A timezone string, e.g., "Asia/Shanghai", "America/New_York"
    • If not provided, the system's default timezone will be used

Return Value

A formatted string representing the current time in the format: YYYY-MM-DD HH:MM:SS.SSSSSS TIMEZONE

Examples

# Get current time in system default timezone
result = await mcp_client.call_tool("get_current_time")
# Example output: "2023-12-25 13:45:30.123456 EST"

# Get current time in a specific timezone
result = await mcp_client.call_tool("get_current_time", timezone="Asia/Shanghai")
# Example output: "2023-12-26 02:45:30.123456 CST"

Project Structure

mcp-time-server/
├── mcp_time_server/
│   ├── __init__.py      # Package initialization
│   └── main.py          # Main server implementation
├── pyproject.toml       # Project configuration
├── README.md            # This file
├── LICENSE              # License file
└── .gitignore           # Git ignore file

License

MIT License - see the LICENSE file for details.

About MCP

The Model Context Protocol (MCP) is an open-source standard for connecting AI applications to external systems. For more information, visit modelcontextprotocol.io.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_cuc_mrjtjmn-0.1.0.tar.gz (3.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_cuc_mrjtjmn-0.1.0-py3-none-any.whl (4.3 kB view details)

Uploaded Python 3

File details

Details for the file mcp_cuc_mrjtjmn-0.1.0.tar.gz.

File metadata

  • Download URL: mcp_cuc_mrjtjmn-0.1.0.tar.gz
  • Upload date:
  • Size: 3.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.3.1 CPython/3.13.0 Darwin/22.6.0

File hashes

Hashes for mcp_cuc_mrjtjmn-0.1.0.tar.gz
Algorithm Hash digest
SHA256 9293b144f11cd16f2e49e4b5797448acdf803b6b864d173bde5a307db496d894
MD5 bee9e02b7a9211f7e8214cb7e49e58f9
BLAKE2b-256 541d3f8abcc95c83bdbc793e13656a94e00a47249fa55a24354a4490f9863c7c

See more details on using hashes here.

File details

Details for the file mcp_cuc_mrjtjmn-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: mcp_cuc_mrjtjmn-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 4.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.3.1 CPython/3.13.0 Darwin/22.6.0

File hashes

Hashes for mcp_cuc_mrjtjmn-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 acad6f00a10785bce54137a8f6387c4908d24ba4ffb41cadb046d4ec6476c43c
MD5 e0b11e4e3a8b1137a17e4850a67ce8ea
BLAKE2b-256 1ad8751c7c3809a466d9858a6494636877b3475c8f2285aeec6a010b9c5ad5b8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page