项目介绍
DevRev MCP Server
概述
DevRev 的 Model Context Protocol 服务器。此服务器提供了对 DevRev API 的全面访问，允许您管理工单（问题、票证）、部分（增强功能）、会议、工作流转换、时间线条目、冲刺计划以及子类型。访问 vista 看板，跨您的 DevRev 数据进行搜索，并使用高级过滤和分页支持检索用户信息。
工具
搜索与发现
search: 使用混合搜索 API 跨 DevRev 搜索信息，支持不同的命名空间（文章、问题、票证、部分、开发人员、账户、组织、看板、事件）。get_current_user: 获取当前认证的 DevRev 用户的详细信息。get_vista: 使用其 ID 在 DevRev 中检索关于 vista（冲刺看板）的信息。Vistas 包含冲刺（vista 组项），可用于过滤和冲刺规划。
工作项（问题与票证）
get_work: 使用其 ID 获取特定 DevRev 工作项的综合信息。create_work: 在 DevRev 中创建新的问题或票证，指定属性如标题、正文、分配人和关联部分。update_work: 更新现有工作项，修改属性如标题、正文、分配人、关联部分或阶段转换。list_works: 根据各种标准（状态、日期、分配人、部分等）列出并筛选工作项。
部分（增强功能）
get_part: 使用其 ID 获取特定部分（增强功能）的详细信息。create_part: 创建新的部分（增强功能），指定属性包括名称、描述、分配人和父部分。update_part: 更新现有部分，修改属性如名称、描述、分配人、目标日期或阶段转换。list_parts: 根据各种标准（日期、分配人、父部分等）列出并筛选部分。
会议与沟通
list_meetings: 根据各种标准（频道、参与者、日期、会议状态等）列出并筛选 DevRev 中的会议。
工作流管理
valid_stage_transition: 获取给定工作项（问题、票证）或部分（增强功能）的有效阶段转换列表。在更新阶段之前使用此功能以确保转换有效。add_timeline_entry: 向工作项（问题、票证）或部分（增强功能）添加时间线条目，以便跟踪更新和进度。get_sprints: 获取给定部分 ID 的活动或计划冲刺，适用于冲刺规划和问题分配。list_subtypes: 列出给定叶类型（问题或票证）的所有可用子类型，使工作项分类更加准确。
先决条件
在使用此 MCP 服务器之前，需要安装 uvx 或 uv，它们是现代的 Python 包和项目管理工具。
安装 uv（推荐）
uv 是一个快速的 Python 包安装器和解析器，它包含 uvx 用于运行 Python 应用程序。
在 macOS 和 Linux 上：
curl -LsSf https://astral.sh/uv/install.sh | sh
在 Windows 上：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
替代安装方法：
使用 Homebrew（macOS）：
brew install uv
使用 pip：
pip install uv
验证安装
安装后，请验证 uv 和 uvx 是否可用：
# 检查 uv 版本
uv --version
# 检查 uvx 版本
uvx --version
两个命令都应返回版本信息。如果收到“命令未找到”错误，请尝试重新启动终端或向 PATH 添加安装目录。
故障排除
遇到问题时：
- 安装后重启终端。
- 检查安装目录是否在 PATH 中。
- 在 macOS/Linux 上，默认安装会将 uv 添加到
~/.cargo/bin/。 - 参考 官方 uv 文档 获取更详细的安装说明。
配置
获取 DevRev API 密钥
- 访问 https://app.devrev.ai/signup 并创建一个帐户。
- 按照此处的说明从现有的数据源（如 Salesforce、Zendesk）导入数据。
- 按照此处的说明生成访问令牌。
使用 Claude Desktop
在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json
在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json
<details> <summary>已发布服务器配置</summary>"mcpServers": {
"devrev": {
"command": "uvx",
"args": [
"devrev-mcp"
],
"env": {
"DEVREV_API_KEY": "YOUR_DEVREV_API_KEY"
}
}
}
"mcpServers": {
"devrev": {
"command": "uv",
"args": [
"--directory",
"Path to src/devrev_mcp directory",
"run",
"devrev-mcp"
],
"env": {
"DEVREV_API_KEY": "YOUR_DEVREV_API_KEY"
}
}
}
功能
- 全面的工作项管理：创建、读取、更新和列出问题和票证，具有高级过滤功能。
- 增强的部分管理：对部分（增强功能）进行完整的 CRUD 操作，包括层级关系。
- 高级搜索：跨多个命名空间（文章、问题、票证、部分、开发人员、账户、组织、看板、事件）进行搜索，具有混合搜索能力。
- Vista 看板集成：访问 vista（冲刺看板）信息并检索冲刺组项，实现有效的冲刺管理。
- 灵活的过滤：根据日期、分配人、状态、自定义字段、子类型等列出和筛选工作项和部分。
- 用户上下文：访问当前用户信息，提供个性化体验。
- 丰富的数据支持：处理工作项、部分、用户、组织和冲刺之间的复杂关系。
- 会议管理：跨不同频道和状态列出和筛选会议，具有全面的日期过滤功能。
- 工作流控制：验证阶段转换并精确管理工作项生命周期。
- 时间线追踪：添加时间线条目以跟踪工作项和部分的进度和更新。
- 冲刺规划：通过 vista 集成访问冲刺信息，实现有效的项目管理和问题分配。
- 子类型管理：列出和管理子类型，以正确分类问题和票证。