MCP请求跟踪器CrunchTools
用于请求跟踪器(RT)票证管理的安全MCP(模型上下文协议)服务器。
特性
- 安全凭证处理:密码存储为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基本身份验证用户名 |
RT_HTTP_PASS | 否 | HTTP基本身份验证密码 |
使用Claude代码
使用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'安全
此服务器在构建时考虑了安全性:
- 秘书:密码使用Pydantic的SecretStr存储,以防止意外记录
- 错误清理:从所有错误消息中清除凭据
- 无文件系统访问权限:服务器从不读取或写入文件
- 不执行Shell:没有子进程或shell命令
- 最小依赖性:只有减少攻击面的基本包
- 自动CVE扫描:通过GitHub Actions进行每周安全扫描
- 集装箱安全:基于蜂鸟图像构建,CVE计数最小
看 安全.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)获得许可。 看 许可证 了解详情。
