请求跟踪管理工具

一个安全的MCP服务器,用于请求跟踪器的票务管理,包括搜索、查看、创建、更新和解决票务等功能。

  • by crunchtools
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 crunchtools/mcp-request-tracker

使用说明

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)获得许可。 看 许可证 了解详情。