MCP Request Tracker CrunchTools

Request Tracker (RT) 티켓 관리를 위한 안전한 MCP(Model Context Protocol) 서버입니다.

기능

• 안전한 자격 증명 처리: 비밀번호는 SecretStr로 저장되며, 절대 로그에 기록되지 않습니다.

• 전체 티켓 관리: 티켓 검색, 보기, 생성, 업데이트 및 해결

• 시간 추적: 티켓에 소요된 시간 추적

• 워크플로우 자동화: 체크리스트 완료와 같은 사전 구축된 워크플로우

• 크로스 플랫폼: Linux, macOS, Windows에서 작동

Related MCP server: YaTracker Connector

설치

옵션 1: uvx 사용 (권장)

uvx mcp-request-tracker-crunchtools

옵션 2: pip 사용

pip install mcp-request-tracker-crunchtools

옵션 3: 컨테이너 사용

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

구성

다음 환경 변수를 설정하세요:

Claude Code와 함께 사용

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

컨테이너 사용

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

사용 가능한 도구

검색 및 보기

• search_tickets - RT 쿼리 구문을 사용하여 티켓 검색

• get_ticket - 티켓 세부 정보 가져오기

• get_ticket_history - 티켓 기록/변경 로그 가져오기

• get_my_open_tickets - 사용자의 열린 티켓 가져오기

• get_new_tickets - 새 티켓/할당되지 않은 티켓 가져오기

티켓 업데이트

• set_ticket_owner - 티켓 소유자 설정

• set_ticket_status - 티켓 상태 설정

• open_ticket - 티켓 열기

• resolve_ticket - 티켓 해결/닫기

• take_ticket - 소유권을 가져와 열기

시간 추적

• set_time_worked - 총 작업 시간 설정

• add_time_worked - 기존 시간에 시간 추가

커뮤니케이션

• add_ticket_comment - 비공개 댓글 추가 (요청자에게 보이지 않음)

• reply_to_ticket - 서신 추가 (요청자에게 보임)

생성

• create_ticket - 새 티켓 생성

워크플로우

• complete_weekly_checklist - 결과와 함께 주간 체크리스트 티켓 완료

RT 쿼리 구문 예제

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

보안

이 서버는 보안을 고려하여 설계되었습니다:

• SecretStr: 비밀번호는 Pydantic의 SecretStr을 사용하여 저장되어 실수로 로그에 기록되는 것을 방지합니다.

• 오류 정화: 모든 오류 메시지에서 자격 증명이 제거됩니다.

• 파일 시스템 접근 없음: 서버는 파일을 읽거나 쓰지 않습니다.

• 셸 실행 없음: 하위 프로세스나 셸 명령이 없습니다.

• 최소 종속성: 공격 표면을 줄이기 위해 필수 패키지만 사용합니다.

• 자동 CVE 스캔: GitHub Actions를 통한 주간 보안 스캔

• 컨테이너 보안: 최소 CVE 수를 가진 Hummingbird 이미지를 기반으로 구축

전체 보안 설계 문서는 SECURITY.md를 참조하세요.

개발

# 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

라이선스

이 프로젝트는 GNU Affero General Public License v3.0 (AGPL-3.0)에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE를 참조하세요.