MCP Time Server

# MCP Time Server Minimal MCP server that returns current time. Timezone configured on client side. ## Installation ```bash python3.13 -m venv .venv .venv/bin/pip install -r requirements.txt ``` ## Configuration Create `config.json`: ```json { "token": "your-secret-token", "port": 23386, "path": "/your-random-path" } ``` ## Running ```bash .venv/bin/python server.py ``` ## Client Configuration ### Claude Code CLI ```bash claude mcp add time --transport sse \ --url "https://DOMAIN/PATH/sse" \ --header "Authorization: Bearer TOKEN" \ --header "X-Timezone: Asia/Novokuznetsk" ``` ### Claude Desktop ```json { "mcpServers": { "time": { "command": "%APPDATA%\\npm\\mcp-remote.cmd", "args": [ "https://DOMAIN/PATH/sse", "--header", "Authorization:Bearer ${MCP_TIME_TOKEN}", "--header", "X-Timezone:${MCP_TIME_TIMEZONE}" ], "env": { "MCP_TIME_TOKEN": "your-token", "MCP_TIME_TIMEZONE": "Asia/Novokuznetsk" } } } } ``` ## Xray + Nginx Setup When running behind Xray VLESS with ALPN-based fallbacks to nginx, add location block to nginx config (both h2 and http/1.1 server blocks): ```nginx location /PATH/ { proxy_pass http://127.0.0.1:PORT; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header Connection ''; proxy_buffering off; proxy_cache off; proxy_read_timeout 86400s; send_timeout 86400s; chunked_transfer_encoding off; add_header X-Accel-Buffering no; } ``` Note: Xray path-based fallbacks only work with HTTP/1.1. For HTTP/2 (ALPN h2), requests go to nginx fallback, so nginx location is required.