测试管理API服务器

Zephyr Scale MCP服务器

Zephyr Scale测试管理工具的MCP服务器。

特性

此MCP服务器提供对Zephyr Scale API v2的全面访问，实现：

• 测试用例管理：创建、读取、更新测试用例和测试步骤
• 测试计划：管理测试计划并将其与测试周期联系起来
• 测试执行：在测试周期内创建和跟踪测试执行
• 文件夹组织：用文件夹组织测试工件
• 状态管理：管理测试实体的自定义状态
• 链路管理：在测试工件之间创建web链接、问题链接和实体链接
• 只读访问：列出项目中配置的优先级和环境

可用工具

测试用例

文件夹

测试计划

测试周期

测试执行

状态

优先事项

环境

链接

安装

与NPM一起使用（推荐）

将以下配置添加到您的 .mcp.json:

{
  "mcpServers": {
    "zephyr-scale": {
      "command": "npx",
      "args": ["-y", "mcp-zephyr-scale"],
      "env": {
        "ZEPHYR_API_TOKEN": "your-api-token-here",
        "JIRA_PROJECT_KEY": "YOUR_PROJECT"
      }
    },
    "atlassian": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.atlassian.com/v1/sse"]
    }
  }
}

为什么要同时使用这两台服务器？

• Zephyr天平MCP：提供测试管理功能（测试用例、测试计划、测试周期、测试执行）
• Atlassian MCP：提供Jira问题管理和Confluence文档访问

这种组合允许您使用API规范创建Jira问题，并将它们链接到测试用例，从而创建从需求到测试执行的完全可追溯性。

所需的环境变量

• ZEPHYR_API_TOKEN：您的Zephyr Scale API代币
• JIRA_PROJECT_KEY：您的Jira项目密钥（例如“KAN”）

如何获取Zephyr API代币

1. 在Jira中，单击您的个人资料图片
2. 选择“Zephyr API密钥”
3. 生成新的API密钥

有关更多信息，请参阅 Zephyr Scale文档.

Atlassian MCP身份验证

首次添加Atlassian MCP服务器时：

1. 服务器将提示您通过OAuth授权访问
2. 您将被重定向到Atlassian以完成身份验证
3. 选择允许访问的产品（Jira和/或Confluence）
4. 点击“批准”完成身份验证

如果您的身份验证过期，您可以使用以下方式重新连接：

• 克劳德代码：运行 /mcp 管理MCP服务器连接的命令，并为Atlassian服务器选择“重新连接”

发展

设置

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Format code
npm run format

# Lint code
npm run lint

# Check code (lint + format)
npm run check

测试本地构建

对于开发，您可以测试本地构建，而不是NPM包。将以下配置添加到您的 .mcp.json:

{
  "mcpServers": {
    "zephyr-scale": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-zephyr-scale/dist/index.js"],
      "env": {
        "ZEPHYR_API_TOKEN": "your-api-token-here",
        "JIRA_PROJECT_KEY": "YOUR_PROJECT"
      }
    }
  }
}

替换 /absolute/path/to/mcp-zephyr-scale 使用到本地存储库的实际绝对路径。

许可证

麻省理工学院