mcp-server-time

library2026.6.4pypypiunverified

mcp-server-time is a Model Context Protocol (MCP) server designed to provide robust tools for time queries and timezone conversions, primarily for integration with Large Language Models (LLMs). It implements the MCP specification, allowing LLMs to accurately retrieve current time information, perform date and time calculations, and handle timezone conversions. The current version is 2026.1.26, following a frequent, calendar-based release cadence.

llm-agents

pip install mcp-server-time uvicorn[standard]

package ↗

INSTALL

IMPORT

SIG · MCP-SERVER-TIME

mcp-server-time

llm-agentspythonv2026.6.4

Install

7.0s avg

Import

—

Disk

78MB

Pass rate

8/ 10

Env Coverage8 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2026.6.4 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✓ —

✓ 8.48s

py 3.11

✓ —

✓ 7.13s

py 3.12

✓ —

✓ 6.1s

py 3.13

✓ —

✓ 6.33s

py 3.9

✕ build_error

78MB installed

● package 78MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

create_app

✓ from mcp_server_time.server import create_app

✗ from mcp_server_time import create_app

The `create_app` function is located within the `server` submodule, not directly under the top-level package.

This quickstart demonstrates how to instantiate and run the MCP Time server using uvicorn. It creates a FastAPI application provided by the library and binds it to host 0.0.0.0 on port 8000, making it accessible for MCP clients.

import uvicorn from mcp_server_time.server import create_app # Create the FastAPI application instance app = create_app() # Run the server programmatically if __name__ == '__main__': # For production, consider using gunicorn or a process manager uvicorn.run(app, host='0.0.0.0', port=8000)

mcp-server-time --version

Debug

Known issues

gotchaThe `uvicorn[standard]` package is a mandatory dependency for running the server locally or in development, but it's not a direct dependency of `mcp-server-time` itself. Ensure you install it alongside the library.

fix

Always install with `pip install mcp-server-time uvicorn[standard]`.

affects: All versions

gotchaThe server uses a default port (8000). If this port is already in use by another application, the server will fail to start. This is a common issue for local development setups.

fix

Change the port when running `uvicorn.run(app, host='0.0.0.0', port=8001)` or `uvicorn main:app --host 0.0.0.0 --port 8001`.

affects: All versions

gotchaThis library provides an MCP *server*. It is designed to be consumed by an MCP-compliant client, typically an LLM agent. It does not offer a standalone Python client API for direct time utility in regular Python scripts.

fix

Ensure your consuming application understands and implements the Model Context Protocol to interact with this server. For direct time utilities in Python, use standard libraries like `datetime` or `zoneinfo`.

affects: All versions

Upgrade

Version history

2026.6.4latest on PyPI · released Jun 4, 2026

Audit

Dependencies

uvicorn[standard]requiredRequired to run the FastAPI server application, not included by default.

Agent activity

13 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/mcp-server-time/ ↗