Datum-Zeit-Tools MCP

Ein Model Context Protocol (MCP) Server für Datum-Zeit-Manipulation und Zeitzonenkonvertierung.

Übersicht

Dieser MCP-Server bietet eine Reihe von Werkzeugen für die Arbeit mit Datum-Zeit-Strings, einschließlich Zeitzonenkonvertierung, Datumsänderung (Arithmetik) und dem Abrufen des aktuellen Datums, der Uhrzeit und der Zeitzone. Er ist als Backend-Dienstprogramm für Anwendungen oder Agenten konzipiert, die robuste, standardisierte Datum-Zeit-Operationen benötigen.

Live-Bereitstellung: https://date-time-tools.iabhishek.workers.dev/mcp

Related MCP server: Time MCP Server

Architektur

Dieser Server läuft auf Cloudflare Workers und verwendet den Streamable HTTP Transport (wobei auch ein Legacy-SSE-Endpunkt bereitgestellt wird). Der Sitzungsstatus wird durch ein Durable Object über den agents McpAgent-Wrapper von Cloudflare gesichert.

Endpunkte:

• POST/GET/DELETE /mcp — Streamable HTTP-Transport. Sitzungen werden über den mcp-session-id-Header nachverfolgt.

• GET /sse, POST /sse/message — Legacy-SSE-Transport für ältere Clients.

Lokale Entwicklung

npm install
npm run dev   # wrangler dev — serves at http://127.0.0.1:8787/mcp

Bereitstellung auf Cloudflare

Manuell

Einmalige Einrichtung:

npx wrangler login

Bereitstellung:

npm run deploy

Wrangler gibt die öffentliche URL aus — für dieses Projekt ist es https://date-time-tools.iabhishek.workers.dev/mcp. Der Workers Free-Plan deckt diesen Server ab (100.000 Anfragen/Tag; das kostenlose Kontingent für Durable Objects deckt die Sitzungsspeicherung ab).

Automatisiert (GitHub Actions)

.github/workflows/deploy.yml führt die Bereitstellung bei jedem Push auf main (und bei manuellem workflow_dispatch) durch. Konfigurieren Sie zwei Repository-Secrets:

• CLOUDFLARE_API_TOKEN — erstellen unter https://dash.cloudflare.com/profile/api-tokens unter Verwendung der Vorlage Edit Cloudflare Workers

• CLOUDFLARE_ACCOUNT_ID — zu finden in der Seitenleiste des Workers & Pages Dashboards

Integration mit MCP-Clients

Claude Code

claude mcp add date-time-tools --transport http https://date-time-tools.iabhishek.workers.dev/mcp

Fügen Sie --scope user hinzu, um es für jedes Projekt zu registrieren, oder --scope project, um eine .mcp.json zu committen, die mit Mitarbeitern geteilt wird. Überprüfen Sie dies mit claude mcp list; führen Sie innerhalb von Claude Code /mcp aus, um Status und Werkzeuge zu überprüfen.

Generische Streamable HTTP-Clients

Konfigurieren Sie Clients, die Streamable HTTP-Transporte unterstützen, so, dass sie auf die bereitgestellte URL verweisen:

{
  "mcpServers": {
    "date-time-tools": {
      "url": "https://date-time-tools.iabhishek.workers.dev/mcp"
    }
  }
}

Für Clients, die nur stdio unterstützen, verwenden Sie eine Brücke mit mcp-remote:

{
  "mcpServers": {
    "date-time-tools": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://date-time-tools.iabhishek.workers.dev/mcp"]
    }
  }
}

Verfügbare Werkzeuge

Dieser MCP-Server bietet die folgenden Werkzeuge für LLMs:

• convertTimezones: Konvertiert einen Datum-Zeit-String von einer Zeitzone in eine andere.

• mutateDate: Addiert oder subtrahiert Tage, Stunden, Minuten, Monate oder Jahre von einem Datum-Zeit-String.

• currentDateTimeAndTimezone: Ruft das aktuelle Datum, die Uhrzeit und die Zeitzone ab.

🧪 Testen mit dem MCP Inspector

Führen Sie npm run dev aus und dann in einem anderen Terminal:

npx -y @modelcontextprotocol/inspector

Wählen Sie den Streamable HTTP-Transport und verwenden Sie http://127.0.0.1:8787/mcp als URL.

Funktionen

• Zeitzonenkonvertierung
  Konvertieren Sie einen Datum-Zeit-String von einer IANA-Zeitzone in eine andere unter Verwendung von Luxon-kompatiblen Formaten.

• Datumsänderung
  Addieren oder subtrahieren Sie Tage, Stunden, Minuten, Monate oder Jahre von einem Datum-Zeit-String.

• Aktuelles Datum-Zeit & Zeitzone
  Rufen Sie das aktuelle Datum, die Uhrzeit und die Zeitzone des Benutzers/Systems ab.