Tracker MCP-Server

Dies ist ein MCP-Server (Model Context Protocol), der für die Verbindung mit Ihrem lokalen tracker-server entwickelt wurde. Er stellt Endpunkte bereit, um den heutigen Zeitplan zu prüfen, Statistiken abzurufen, Aufgaben zu registrieren und Timer direkt für LLM-Clients (wie Claude Desktop oder Cursor) zu verwalten.

Voraussetzungen

• Eine laufende Instanz von tracker-server (normalerweise unter http://localhost:3000).

• Python 3.11+ (bei lokaler Ausführung) oder Docker.

Related MCP server: mcp-server-tasktracker

🚀 Ausführung via Docker (Empfohlen)

Wenn Sie Ihren MCP-Agenten bereitstellen, können Sie ihn direkt mit dem Docker-Image aus der GitHub Container Registry verknüpfen.

Da der tracker-server lokal auf Ihrem Host-Rechner läuft, muss Docker wissen, wie er erreicht werden kann. Das Image verwendet standardmäßig http://host.docker.internal:3000, unter der Annahme, dass Sie Mac/Windows oder Docker Desktop verwenden.

Für die Claude Desktop-Konfiguration (claude_desktop_config.json):

{
  "mcpServers": {
    "tracker-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TRACKER_API_URL=http://host.docker.internal:3000",
        "ghcr.io/makegorka/tracker-mcp:latest"
      ]
    }
  }
}

Hinweis: Beachten Sie das -i Flag. Da MCP über stdin/stdout (stdio) kommuniziert, müssen Sie den Docker-Container interaktiv ausführen, jedoch ohne TTY (-t).

🛠 Lokale Ausführung

Falls Sie entwickeln oder es vorziehen, den Quellcode anstelle von Docker auszuführen.

1. Einrichtung der virtuellen Umgebung:

cd tracker-mcp
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

2. Manuelles Ausführen des MCP-Servers:

# Make sure your tracker server is running!
python server.py

Hinweis: Dies blockiert Ihr Terminal, während auf stdio MCP JSON RPC-Befehle gewartet wird. Dies ist so beabsichtigt.

3. Konfiguration von Claude Desktop (Lokaler Modus):

{
  "mcpServers": {
    "tracker-mcp": {
      "command": "/absolute/path/to/tracker-mcp/venv/bin/python",
      "args": [
        "/absolute/path/to/tracker-mcp/server.py"
      ],
      "env": {
        "TRACKER_API_URL": "http://localhost:3000"
      }
    }
  }
}