Time MCP Server

Ein Model Context Protocol-Server, der Zeit- und Zeitzonenumrechnungsfunktionen bereitstellt. Dieser Server ermöglicht LLMs, aktuelle Zeitinformationen abzurufen und Zeitzonenumrechnungen mithilfe von IANA-Zeitzonennamen durchzuführen, mit automatischer Erkennung der Systemzeitzone.

Verfügbare Tools

• get_current_time - Aktuelle Zeit in einer bestimmten Zeitzone oder der Systemzeitzone abrufen.

  • Erforderliche Argumente:

    • timezone (string): IANA-Zeitzonenname (z. B. 'America/New_York', 'Europe/London')

• convert_time - Zeit zwischen Zeitzonen umrechnen.

  • Erforderliche Argumente:

    • source_timezone (string): Quell-IANA-Zeitzonenname

    • time (string): Zeit im 24-Stunden-Format (HH:MM)

    • target_timezone (string): Ziel-IANA-Zeitzonenname

Installation

Mit uv (empfohlen)

Bei Verwendung von uv ist keine spezielle Installation erforderlich. Wir werden uvx verwenden, um mcp-server-time direkt auszuführen.

uvx mcp-server-time

Mit PIP

Alternativ können Sie mcp-server-time über pip installieren:

pip install mcp-server-time

Nach der Installation können Sie es als Skript mit folgendem Befehl ausführen:

python -m mcp_server_time

Related MCP server: Time MCP Server

Konfiguration

Konfiguration für Claude.app

Fügen Sie zu Ihren Claude-Einstellungen hinzu:

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time"]
    }
  }
}

{
  "mcpServers": {
    "time": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "LOCAL_TIMEZONE", "mcp/time"]
    }
  }
}

{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": ["-m", "mcp_server_time"]
    }
  }
}

Konfiguration für Zed

Fügen Sie zu Ihrer Zed settings.json hinzu:

"context_servers": [
  "mcp-server-time": {
    "command": "uvx",
    "args": ["mcp-server-time"]
  }
],

"context_servers": {
  "mcp-server-time": {
    "command": "python",
    "args": ["-m", "mcp_server_time"]
  }
},

Konfiguration für VS Code

Für eine schnelle Installation verwenden Sie einen der untenstehenden Ein-Klick-Installationsbuttons...

Für die manuelle Installation fügen Sie den folgenden JSON-Block zu Ihrer Datei „User Settings (JSON)“ in VS Code hinzu. Sie können dies tun, indem Sie Ctrl + Shift + P drücken und Preferences: Open User Settings (JSON) eingeben.

Optional können Sie ihn zu einer Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich hinzufügen. Dadurch können Sie die Konfiguration mit anderen teilen.

Beachten Sie, dass der Schlüssel mcp erforderlich ist, wenn Sie die Datei mcp.json verwenden.

{
  "mcp": {
    "servers": {
      "time": {
        "command": "uvx",
        "args": ["mcp-server-time"]
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "time": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/time"]
      }
    }
  }
}

Konfiguration für Zencoder

1. Gehen Sie zum Zencoder-Menü (...)

2. Wählen Sie im Dropdown-Menü Agent Tools aus.

3. Klicken Sie auf Add Custom MCP.

4. Fügen Sie den Namen und die Serverkonfiguration von unten hinzu und stellen Sie sicher, dass Sie auf den Button Install klicken.

{
    "command": "uvx",
    "args": ["mcp-server-time"]
  }

Anpassung - Systemzeitzone

Standardmäßig erkennt der Server automatisch die Zeitzone Ihres Systems. Sie können dies überschreiben, indem Sie das Argument --local-timezone zur args-Liste in der Konfiguration hinzufügen.

Beispiel:

{
  "command": "python",
  "args": ["-m", "mcp_server_time", "--local-timezone=America/New_York"]
}

Beispiel-Interaktionen

1. Aktuelle Zeit abrufen:

{
  "name": "get_current_time",
  "arguments": {
    "timezone": "Europe/Warsaw"
  }
}

Antwort:

{
  "timezone": "Europe/Warsaw",
  "datetime": "2024-01-01T13:00:00+01:00",
  "is_dst": false
}

2. Zeit zwischen Zeitzonen umrechnen:

{
  "name": "convert_time",
  "arguments": {
    "source_timezone": "America/New_York",
    "time": "16:30",
    "target_timezone": "Asia/Tokyo"
  }
}

Antwort:

{
  "source": {
    "timezone": "America/New_York",
    "datetime": "2024-01-01T12:30:00-05:00",
    "is_dst": false
  },
  "target": {
    "timezone": "Asia/Tokyo",
    "datetime": "2024-01-01T12:30:00+09:00",
    "is_dst": false
  },
  "time_difference": "+13.0h",
}

Debugging

Sie können den MCP-Inspektor verwenden, um den Server zu debuggen. Für uvx-Installationen:

npx @modelcontextprotocol/inspector uvx mcp-server-time

Oder wenn Sie das Paket in einem bestimmten Verzeichnis installiert haben oder daran entwickeln:

cd path/to/servers/src/time
npx @modelcontextprotocol/inspector uv run mcp-server-time

Beispiele für Fragen an Claude

1. „Wie spät ist es gerade?“ (wird die Systemzeitzone verwendet)

2. „Wie spät ist es in Tokio?“

3. „Wenn es in New York 16 Uhr ist, wie spät ist es in London?“

4. „Konvertieren Sie 9:30 Uhr Tokio-Zeit in New Yorker Zeit.“

Build

Docker-Build:

cd src/time
docker build -t mcp/time .

Mitwirken

Wir freuen uns über Beiträge, die helfen, mcp-server-time zu erweitern und zu verbessern. Ob Sie neue zeitbezogene Tools hinzufügen, bestehende Funktionen verbessern oder die Dokumentation verbessern möchten – Ihr Beitrag ist wertvoll.

Beispiele für andere MCP-Server und Implementierungsmuster finden Sie unter: https://github.com/modelcontextprotocol/servers

Pull Requests sind willkommen! Zögern Sie nicht, neue Ideen, Fehlerbehebungen oder Verbesserungen beizutragen, um mcp-server-time noch leistungsfähiger und nützlicher zu machen.

Lizenz

mcp-server-time ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software frei verwenden, modifizieren und verbreiten können, vorbehaltlich der Bedingungen der MIT-Lizenz. Weitere Details finden Sie in der Datei LICENSE im Projekt-Repository.