README.md

---
title: dateutil MCP Service
emoji: 🔧
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
license: mit
---

# dateutil MCP Service

This deployment packages `python-dateutil` as an MCP service using FastMCP.
It supports local `stdio` mode and Docker/HTTP mode for HuggingFace Spaces.

## Available MCP Tools

- `health_check`
- `parse_datetime`
- `parse_iso_datetime`
- `compute_relativedelta`
- `generate_rrule_occurrences`
- `resolve_timezone`
- `calculate_easter`
- `list_loaded_modules`

## Local stdio usage

```bash
cd dateutil/mcp_output
python start_mcp.py
```

Or explicitly:

```bash
MCP_TRANSPORT=stdio MCP_PORT=8000 python start_mcp.py
```

For local CLI / Claude Desktop style clients, use stdio transport.

## HTTP client usage

Run in HTTP mode:

```bash
MCP_TRANSPORT=http MCP_PORT=7860 python dateutil/mcp_output/start_mcp.py
```

Then connect MCP clients to:

- `http://localhost:7860/mcp`

For HuggingFace Spaces, the public endpoint is:

- `https://<your-space-host>/mcp`

## Docker

Build and run:

```bash
bash run_docker.sh
```

Or on PowerShell:

```powershell
./run_docker.ps1
```

The Docker entrypoint is `python dateutil/mcp_output/start_mcp.py`.