Metadata-Version: 2.4
Name: time-mcp-pypi
Version: 1.1.1
Summary: A Model Context Protocol (MCP) server that provides current UTC time in RFC 3339 format
License-Expression: MIT
Project-URL: Homepage, https://github.com/domdomegg/time-mcp-pypi
Project-URL: Repository, https://github.com/domdomegg/time-mcp-pypi.git
Project-URL: Issues, https://github.com/domdomegg/time-mcp-pypi/issues
Keywords: mcp,model-context-protocol,time,utc,timestamp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp==1.13.1
Dynamic: license-file

# 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:

```bash
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`:

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

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

```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':
   ```bash
   git tag v1.0.1
   ```

3. **Push the tag** to trigger the publishing pipeline:
   ```bash
   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

<!-- mcp-name: io.github.domdomegg/time-mcp-pypi -->
