Time MCP Server

Time MCP Server

A minimal Model Context Protocol (MCP) server built with Python.

The server provides one simple tool:

• get_current_utc_time - Gets the current UTC date and time in RFC 3339 format

Quick start

Prerequisites:

• Python 3.8 or later
• Claude Desktop or another MCP-compatible client

Install and run with:

pip install time-mcp-pypi  # or from a local clone: pip install -e .
time-mcp-pypi

Configuration

To use this server with Claude Desktop, add the following to your MCP configuration file:

Windows

Add to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "time-server": {
      "command": "time-mcp-pypi"
    }
  }
}

macOS

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "time-server": {
      "command": "time-mcp-pypi"
    }
  }
}

Usage

Once configured, you can use the time tool in Claude Desktop:

• "What's the current UTC time?"
• "Give me an RFC 3339 timestamp"

Publishing New Versions

To publish a new version of the package:

1. Update the version in pyproject.toml, and commit as Release x.y.z

2. Tag the release with a version number prefixed with 'v':

   git tag v1.0.1
   

3. Push the tag to trigger the publishing pipeline:

   git push --tags
   

Then the CI/CD pipeline will automatically publish the package.

CI/CD

The project includes GitHub Actions workflows for:

• Build & Test - Builds and tests the Python package
• Publish - Automatically publishes to PyPI and creates GitHub releases on version tags