使用说明
DateTime PDT - Remote MCP Server
A remote Model Context Protocol (MCP) server that returns the current date and time in Pacific time (America/Vancouver) with the zone's live IANA abbreviation (PDT/PST, or MST under BC's permanent UTC-7). No authentication required.
Tool
get_current_datetime_pdt
Returns the current date and time in Pacific time (America/Vancouver), formatted as DayOfWeek Month DD, YYYY HH:MMam/pm TZ, where TZ is the zone's IANA abbreviation — PDT/PST historically, and MST (permanent UTC-7) from 2026-11-01 per BC's move to permanent daylight time.
Example response:
Saturday April 04, 2026 06:11pm PDT
Quick Start
Docker Compose (recommended)
docker compose up -d
Docker
docker build -t datetime-mcp .
docker run -d -p 8222:8000 datetime-mcp
Local
pip install -r requirements.txt
python server.py
The server starts on http://localhost:8222 using the Streamable HTTP transport.
MCP Client Configuration
Claude Code
Add to your Claude Code MCP settings:
{
"mcpServers": {
"datetime-pdt": {
"type": "streamable-http",
"url": "http://localhost:8222/mcp"
}
}
}
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"datetime-pdt": {
"type": "streamable-http",
"url": "http://localhost:8222/mcp"
}
}
}
Cursor / Windsurf / Other MCP Clients
Point your client to the Streamable HTTP endpoint:
http://localhost:8222/mcp
Testing
Run the test suite with pytest in a virtualenv:
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt -r requirements-dev.txt
.venv/bin/python -m pytest -q
tests/unit/ covers the pure formatter against fixed datetimes (no clock);
tests/integration/ drives the FastMCP server in-process (no container, no network).
Verify a running server with curl:
# Initialize a session
curl -X POST http://localhost:8222/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
Project record
Start at docs/Home.md for the record: the decision log (D / F / P / O), explorations, and the working agreement.
Project Structure
.
├── server.py # MCP server + the pure formatter
├── requirements.txt # Runtime dependencies
├── requirements-dev.txt # Test dependencies (pytest)
├── tests/ # unit/ (formatter) + integration/ (FastMCP in-process)
├── Dockerfile # Container image definition
├── docker-compose.yml # Docker Compose configuration
└── README.md
Tech Stack
- Python 3.13
- MCP Python SDK (FastMCP)
- Uvicorn (ASGI server)
- Docker
