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