A Model Context Protocol (MCP) server that provides current UTC time in RFC 3339 format
Project description
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:
-
Update the version in
pyproject.toml, and commit asRelease x.y.z -
Tag the release with a version number prefixed with 'v':
git tag v1.0.1
-
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
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file time_mcp_pypi-1.1.1.tar.gz.
File metadata
- Download URL: time_mcp_pypi-1.1.1.tar.gz
- Upload date:
- Size: 3.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2b63f964db00d4cdb67197a7129e8359bd0456889df204d37b1e239d4f40bce1
|
|
| MD5 |
9a777a354699d175401aeeb6ce607c33
|
|
| BLAKE2b-256 |
6ee8012ad90d2c3d9e0d843ce547464acbae1ee6593a0217f255af2a5c03a852
|
File details
Details for the file time_mcp_pypi-1.1.1-py3-none-any.whl.
File metadata
- Download URL: time_mcp_pypi-1.1.1-py3-none-any.whl
- Upload date:
- Size: 4.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cf579046f4d5a1cf99eb3d20f4109ccc36985259e1aa2a3f65f455cf77b6f4bb
|
|
| MD5 |
8eafa942d979b39f52ad13f06e0eb042
|
|
| BLAKE2b-256 |
0aac8d5e658c8ae844de467e395701c0fcffaf69975d889ff05afab00f1a252c
|