MCP Request Tracker CrunchTools

Ein sicherer MCP (Model Context Protocol) Server für die Ticketverwaltung von Request Tracker (RT).

Funktionen

• Sichere Handhabung von Anmeldedaten: Passwörter werden als SecretStr gespeichert, nie protokolliert

• Vollständige Ticketverwaltung: Tickets suchen, anzeigen, erstellen, aktualisieren und auflösen

• Zeiterfassung: Erfassen Sie die an Tickets gearbeitete Zeit

• Workflow-Automatisierung: Vorgefertigte Workflows wie Checklisten-Abschluss

• Plattformübergreifend: Funktioniert unter Linux, macOS und Windows

Related MCP server: YaTracker Connector

Installation

Option 1: Mit uvx (empfohlen)

uvx mcp-request-tracker-crunchtools

Option 2: Mit pip

pip install mcp-request-tracker-crunchtools

Option 3: Mit Container

podman run -e RT_URL=... -e RT_USER=... -e RT_PASS=... quay.io/crunchtools/mcp-request-tracker

Konfiguration

Legen Sie die folgenden Umgebungsvariablen fest:

Verwendung mit Claude Code

Mit uvx

claude mcp add mcp-request-tracker-crunchtools \
    --env RT_URL=https://rt.example.com \
    --env RT_USER=your_username \
    --env RT_PASS=your_password \
    -- uvx mcp-request-tracker-crunchtools

Mit Container

claude mcp add mcp-request-tracker-crunchtools \
    --env RT_URL=https://rt.example.com \
    --env RT_USER=your_username \
    --env RT_PASS=your_password \
    -- podman run -i --rm -e RT_URL -e RT_USER -e RT_PASS quay.io/crunchtools/mcp-request-tracker

Verfügbare Tools

Suche und Anzeige

• search_tickets - Suchen Sie Tickets mit der RT-Abfragesyntax

• get_ticket - Ticketdetails abrufen

• get_ticket_history - Ticketverlauf/Änderungsprotokoll abrufen

• get_my_open_tickets - Offene Tickets für einen Benutzer abrufen

• get_new_tickets - Neue/nicht zugewiesene Tickets abrufen

Tickets aktualisieren

• set_ticket_owner - Ticketbesitzer festlegen

• set_ticket_status - Ticketstatus festlegen

• open_ticket - Ein Ticket öffnen

• resolve_ticket - Ein Ticket auflösen/schließen

• take_ticket - Übernahme und Öffnen

Zeiterfassung

• set_time_worked - Gesamtarbeitszeit festlegen

• add_time_worked - Zeit zur vorhandenen Zeit hinzufügen

Kommunikation

• add_ticket_comment - Privaten Kommentar hinzufügen (für den Anfragenden nicht sichtbar)

• reply_to_ticket - Korrespondenz hinzufügen (für den Anfragenden sichtbar)

Erstellung

• create_ticket - Ein neues Ticket erstellen

Workflows

• complete_weekly_checklist - Ein wöchentliches Checklisten-Ticket mit Ergebnissen abschließen

Beispiele für RT-Abfragesyntax

Status = 'new'
Status = 'open' AND Owner = 'scott'
Subject LIKE 'checklist'
Queue = 'Professional'
Created > '2025-01-01'
Owner = 'Nobody'

Sicherheit

Dieser Server wurde mit Blick auf Sicherheit entwickelt:

• SecretStr: Passwörter werden mit Pydantics SecretStr gespeichert, um versehentliches Protokollieren zu verhindern

• Fehlerbereinigung: Anmeldedaten werden aus allen Fehlermeldungen entfernt

• Kein Dateisystemzugriff: Der Server liest oder schreibt niemals Dateien

• Keine Shell-Ausführung: Keine Unterprozesse oder Shell-Befehle

• Minimale Abhängigkeiten: Nur wesentliche Pakete, um die Angriffsfläche zu reduzieren

• Automatisierte CVE-Scans: Wöchentliche Sicherheitsscans über GitHub Actions

• Containersicherheit: Basierend auf Hummingbird-Images mit minimaler CVE-Anzahl

Siehe SECURITY.md für das vollständige Sicherheitsdesign-Dokument.

Entwicklung

# Clone the repository
git clone https://github.com/crunchtools/mcp-request-tracker.git
cd mcp-request-tracker

# Install dependencies
uv sync --all-extras

# Run tests
uv run pytest

# Lint
uv run ruff check src tests

# Type check
uv run mypy src

Lizenz

Dieses Projekt ist unter der GNU Affero General Public License v3.0 (AGPL-3.0) lizenziert. Siehe LICENSE für Details.