MCP Request Tracker CrunchTools

Un servidor MCP (Model Context Protocol) seguro para la gestión de tickets de Request Tracker (RT).

Características

• Manejo seguro de credenciales: Las contraseñas se almacenan como SecretStr, nunca se registran

• Gestión completa de tickets: Buscar, ver, crear, actualizar y resolver tickets

• Seguimiento de tiempo: Registrar el tiempo trabajado en los tickets

• Automatización de flujos de trabajo: Flujos de trabajo predefinidos como la finalización de listas de verificación

• Multiplataforma: Funciona en Linux, macOS y Windows

Related MCP server: YaTracker Connector

Instalación

Opción 1: Usando uvx (Recomendado)

uvx mcp-request-tracker-crunchtools

Opción 2: Usando pip

pip install mcp-request-tracker-crunchtools

Opción 3: Usando Contenedor

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

Configuración

Establezca las siguientes variables de entorno:

Uso con Claude Code

Usando 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

Usando Contenedor

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

Herramientas Disponibles

Búsqueda y Visualización

• search_tickets - Buscar tickets usando la sintaxis de consulta de RT

• get_ticket - Obtener detalles del ticket

• get_ticket_history - Obtener historial/cambios del ticket

• get_my_open_tickets - Obtener tickets abiertos de un usuario

• get_new_tickets - Obtener tickets nuevos/sin asignar

Actualizar Tickets

• set_ticket_owner - Establecer propietario del ticket

• set_ticket_status - Establecer estado del ticket

• open_ticket - Abrir un ticket

• resolve_ticket - Resolver/cerrar un ticket

• take_ticket - Tomar posesión y abrir

Seguimiento de Tiempo

• set_time_worked - Establecer el tiempo total trabajado

• add_time_worked - Añadir tiempo al tiempo existente

Comunicación

• add_ticket_comment - Añadir comentario privado (no visible para el solicitante)

• reply_to_ticket - Añadir correspondencia (visible para el solicitante)

Creación

• create_ticket - Crear un nuevo ticket

Flujos de Trabajo

• complete_weekly_checklist - Completar un ticket de lista de verificación semanal con resultados

Ejemplos de Sintaxis de Consulta RT

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

Seguridad

Este servidor está diseñado con la seguridad en mente:

• SecretStr: Las contraseñas se almacenan usando SecretStr de Pydantic para evitar registros accidentales

• Saneamiento de errores: Las credenciales se eliminan de todos los mensajes de error

• Sin acceso al sistema de archivos: El servidor nunca lee ni escribe archivos

• Sin ejecución de shell: No hay subprocesos ni comandos de shell

• Dependencias mínimas: Solo paquetes esenciales para reducir la superficie de ataque

• Escaneo CVE automatizado: Escaneos de seguridad semanales a través de GitHub Actions

• Seguridad del contenedor: Construido sobre imágenes Hummingbird con un número mínimo de CVE

Consulte SECURITY.md para el documento completo de diseño de seguridad.

Desarrollo

# 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

Licencia

Este proyecto está licenciado bajo la Licencia Pública General de GNU Affero v3.0 (AGPL-3.0). Consulte LICENSE para más detalles.