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 添加安装目录。

故障排除

遇到问题时：

1. 安装后重启终端。
2. 检查安装目录是否在 PATH 中。
3. 在 macOS/Linux 上，默认安装会将 uv 添加到 ~/.cargo/bin/。
4. 参考 官方 uv 文档 获取更详细的安装说明。

配置

获取 DevRev API 密钥

1. 访问 https://app.devrev.ai/signup 并创建一个帐户。
2. 按照此处的说明从现有的数据源（如 Salesforce、Zendesk）导入数据。
3. 按照此处的说明生成访问令牌。

使用 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"
    }
  }
}

</details> <details> <summary>开发/未发布服务器配置</summary>

"mcpServers": {
  "devrev": {
    "command": "uv",
    "args": [
      "--directory",
      "Path to src/devrev_mcp directory",
      "run",
      "devrev-mcp"
    ],
    "env": {
      "DEVREV_API_KEY": "YOUR_DEVREV_API_KEY"
    }
  }
}

</details>

功能

• 全面的工作项管理：创建、读取、更新和列出问题和票证，具有高级过滤功能。
• 增强的部分管理：对部分（增强功能）进行完整的 CRUD 操作，包括层级关系。
• 高级搜索：跨多个命名空间（文章、问题、票证、部分、开发人员、账户、组织、看板、事件）进行搜索，具有混合搜索能力。
• Vista 看板集成：访问 vista（冲刺看板）信息并检索冲刺组项，实现有效的冲刺管理。
• 灵活的过滤：根据日期、分配人、状态、自定义字段、子类型等列出和筛选工作项和部分。
• 用户上下文：访问当前用户信息，提供个性化体验。
• 丰富的数据支持：处理工作项、部分、用户、组织和冲刺之间的复杂关系。
• 会议管理：跨不同频道和状态列出和筛选会议，具有全面的日期过滤功能。
• 工作流控制：验证阶段转换并精确管理工作项生命周期。
• 时间线追踪：添加时间线条目以跟踪工作项和部分的进度和更新。
• 冲刺规划：通过 vista 集成访问冲刺信息，实现有效的项目管理和问题分配。
• 子类型管理：列出和管理子类型，以正确分类问题和票证。