MCP Request Tracker CrunchTools

一个用于 Request Tracker (RT) 工单管理的安全 MCP（模型上下文协议）服务器。

功能特性

• 安全凭据处理：密码以 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 存储，以防止意外记录

• 错误清理：所有错误消息中都会清除凭据

• 无文件系统访问：服务器从不读取或写入文件

• 无 Shell 执行：无子进程或 shell 命令

• 最小依赖：仅包含必要的包以减少攻击面

• 自动 CVE 扫描：通过 GitHub Actions 进行每周安全扫描

• 容器安全：基于 Hummingbird 镜像构建，CVE 数量最少

有关完整的安全设计文档，请参阅 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 通用公共许可证 v3.0（AGPL-3.0）授权。 有关详细信息，请参阅 LICENSE。