MCP Request-tracker

MCP Request Tracker CrunchTools

Request Tracker（RT）のチケット管理用の安全な MCP（Model Context Protocol）サーバーです。

機能

• 安全な認証情報の取り扱い：パスワードは SecretStr として保存され、ログに記録されません
• 包括的なチケット管理：チケットの検索、表示、作成、更新、解決に対応
• 時間管理：チケットに費やした時間を記録
• ワークフローの自動化：チェックリストの完了など、事前構築済みのワークフロー
• クロスプラットフォーム：Linux、macOS、Windows で動作

インストール

オプション 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

設定

以下の環境変数を設定します。

変数	必須	説明
RT_URL	はい	RT サーバーのベース URL
RT_USER	はい	RT のユーザー名
RT_PASS	はい	RT のパスワード
RT_HTTP_USER	いいえ	HTTP Basic 認証のユーザー名
RT_HTTP_PASS	いいえ	HTTP Basic 認証のパスワード

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 を参照してください。