Zephyr MCP server

MCP办公协作

提供方 Milo0821

办公协作 未标注 Token 社区 / 第三方

Zephyr Scale MCP Server是一个支持Jira Cloud和Data Center的测试管理服务器,提供创建、读取和管理测试用例的功能,并通过统一的资源系统访问实时测试数据。

一句话选型结论

按资料字段整理

Zephyr MCP server 属于办公协作类 MCP 服务器,传输方式未标注,Token,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 12 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量12暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

测试管理TypeScript本地部署Jira集成RESTAPIBDD测试测试生命周期管理

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 12 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 12 个工具,覆盖面较广,能满足多种调用。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zephyr MCP server当前 12 未标注 未标注 无 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Milo0821上游标注的维护方 Milo0821
分类办公协作本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.6 KB
来自项目仓库与上游目录的原文,未做删改

Zephyr Scale MCP服务器

用于Zephyr Scale测试管理的模型上下文协议服务器,支持两者 Jira云和数据中心.通过带有的Atlassian REST API创建、读取和管理测试用例 符合API的官方模式通过统一的资源系统访问实时测试用例数据、示例有效载荷和文件资源。

特性

  • ✅ Jira云和数据中心支持:通过自动配置检测无缝连接到Jira Cloud(使用API v2)和自托管数据中心实例(使用API v1)。
  • ✅ 符合API的官方架构:工具和数据结构与官方Zephyr Scale REST API相匹配,确保兼容性和可靠性。
  • ✅ 统一测试用例创建:单身 create_test_case 该工具处理所有脚本类型(BDD、分步、纯文本),以简化工作流程。
  • ✅ 全测试生命周期管理:用于创建、读取、删除测试用例以及管理测试运行、执行和文件夹的综合工具。
  • ✅ 实时模板系统:使用Zephyr实例中的真实测试用例作为模板(zephyr://testcase/KEY)确保一致性和正确的项目特定字段。
  • ✅ 统一资源系统:访问Zephyr实时数据、本地文件(file://),并通过一致的基于URI的系统内置示例。

安装和配置

您可以使用以下命令运行服务器 npx 无需安装,或从全局安装 npm.

使用npx(推荐)

使用以下结构配置MCP客户端。

Jira Cloud:```json
{
"mcpServers": {
"zephyr-server": {
"command": "npx",
"args": ["zephyr-scale-mcp-server@latest"],
"env": {
"ZEPHYR_BASE_URL": "https://your-company.atlassian.net",
"ZEPHYR_API_KEY": "your-zephyr-api-key",
"JIRA_USERNAME": "your-email@company.com",
"JIRA_API_TOKEN": "your-jira-api-token"
}
}
}
}


> **备注**: `JIRA_USERNAME` 和 `JIRA_API_TOKEN` 是可选的,但如果您想使用 `issue_links` 创建测试用例时使用字段。没有它们,问题链接将失败,并显示401警告(测试用例仍在创建中)。在生成Jira API令牌 id.atlassian.com/manage-profile/security/api-tokens.

**Jira Cloud(欧盟地区):**```json
{
"mcpServers": {
"zephyr-server": {
"command": "npx",
"args": ["zephyr-scale-mcp-server@latest"],
"env": {
"ZEPHYR_BASE_URL": "https://your-company.atlassian.net",
"ZEPHYR_API_KEY": "your-zephyr-api-key",
"JIRA_USERNAME": "your-email@company.com",
"JIRA_API_TOKEN": "your-jira-api-token",
"ZEPHYR_API_BASE_URL": "https://eu.api.zephyrscale.smartbear.com/v2"
}
}
}
}

Jira数据中心:```json
{
"mcpServers": {
"zephyr-server": {
"command": "npx",
"args": ["zephyr-scale-mcp-server@latest"],
"env": {
"ZEPHYR_BASE_URL": "https://your-jira-server.com",
"ZEPHYR_API_KEY": "your-api-token"
}
}
}
}


### 使用全局npm安装

首先全局安装软件包:```bash
npm install -g zephyr-scale-mcp-server

然后,更新 command 在MCP配置中 "command": "zephyr-scale-mcp".

核心概念

统一API

最新版本具有 统一的 create_test_case 工具 它通过一个一致的接口支持所有测试脚本类型(STEP_BY_STEP、PLAIN_TEXT和BDD)。这与官方Zephyr Scale REST API v1结构完全匹配,简化了测试创建过程。

Jira云与数据中心

服务器会自动检测您的Jira环境,并使用相应的API版本:

  • 吉拉云:使用Zephyr Scale API v2。
  • Jira数据中心:使用Zephyr Scale API v1。

有些工具是特定于平台的。例如, add_test_cases_to_run 仅在云上可用,因为数据中心API(v1)不支持在创建后修改测试运行。

资源系统

服务器通过URI方案提供对各种资源的访问:

  • zephyr://testcase/YOUR-TEST-CASE-KEY:从Zephyr实例中获取真实的测试用例数据用作模板。
  • file:///absolute/path/to/your/file.json:读取用户提供的文件。
  • zephyr://examples/...:访问内置示例有效载荷。

工具参考

测试用例管理

  • get_test_case:获取特定测试用例的详细信息。
  • create_test_case:使用STEP_BY_STEP、PLAIN_TEXT或BDD内容创建测试用例。
  • delete_test_case:删除特定的测试用例。
  • update_test_case_bdd:使用BDD内容更新现有测试用例(可选地更新测试用例名称)。

试运行管理

  • create_test_run:创建新的测试运行。
  • get_test_run:获取有关特定测试运行的详细信息。
  • get_test_run_cases:从测试运行中获取测试用例密钥。
  • add_test_cases_to_run:将测试用例添加到现有测试运行中。 (仅限云)

测试执行和搜索

  • get_test_execution:获取详细的单个测试执行结果。
  • search_test_cases_by_folder:在特定文件夹中搜索测试用例。
  • search_test_runs:按项目键和/或文件夹路径搜索测试运行。

组织

  • create_folder:在Zephyr Scale中创建一个新文件夹。

用法示例

使用问题链接创建BDD测试用例```json

{
"project_key": "PROJ",
"name": "User Authentication",
"test_script": {
"type": "BDD",
"text": "Given a user with valid credentials\nWhen the user attempts to log in\nThen the user should be authenticated successfully"
},
"issue_links": ["PROJ-123", "PROJ-456"]
}


**备注**: `issue_links` 需要 `JIRA_USERNAME` 和 `JIRA_API_TOKEN` 待设置(仅限云)。链接失败被报告为警告——测试用例仍在创建中。

### 使用实时测试用例作为模板

1. 获取现有测试用例: `zephyr://testcase/PROJ-T123`
1. 复制其结构(尤其是 `customFields` 和 `folder`).
1. 使用相同的项目特定配置创建新的测试用例。

### 创建测试运行```json
{
"project_key": "PROJ",
"name": "Sprint 1 Test Run",
"test_case_keys": ["PROJ-T123", "PROJ-T124", "PROJ-T125"]
}

更新现有BDD测试用例```json

{
"test_case_key": "PROJ-T123",
"name": "Ensure the axial-flow pump is enabled",
"bdd_content": "Feature: Pump Enablement\n\nScenario: Enable the pump\n Given the system is powered on\n When the operator enables the axial-flow pump\n Then the pump should report as enabled"
}
```

备注:服务器将在可能的情况下将markdown风格的BDD转换为Gherkin,并保留所有其他现有的测试用例字段。

认证

Jira云配置

变量 必填 描述
ZEPHYR_BASE_URL ✅ 您的Jira Cloud URL,例如。 https://your-company.atlassian.net
ZEPHYR_API_KEY ✅ Zephyr Scale API密钥(JWT)。在Jira中生成:个人资料图片(左下)→ Zephyr API密钥
JIRA_USERNAME ⚠️ 可选* 您的Jira帐户电子邮件地址
JIRA_API_TOKEN ⚠️ 可选* Jira API令牌。生成时间 id.atlassian.com/manage-profile/security/api-tokens
ZEPHYR_API_BASE_URL 可选 覆盖Zephyr API基本URL(例如,对于欧盟: https://eu.api.zephyrscale.smartbear.com/v2).默认为US端点。
JIRA_TYPE 可选 强制 "cloud" 或 "datacenter" --覆盖自动检测

> * JIRA_USERNAME + JIRA_API_TOKEN:仅适用于 issue_links 云上的功能。Zephyr API密钥无法根据Jira REST API进行身份验证,因此需要一个单独的Jira凭据来解决数字ID的问题密钥。没有这些, issue_links 将失败并发出401警告——测试用例仍成功创建。

Jira数据中心配置

变量 必填 描述
ZEPHYR_BASE_URL ✅ 您的Jira服务器URL,例如。 https://your-jira-server.com
ZEPHYR_API_KEY ✅ Jira配置文件设置中的Zephyr Scale API令牌
JIRA_TYPE 可选 设置为 "datacenter" 覆盖自动检测

自动检测

服务器会根据以下内容自动检测您的Jira类型 ZEPHYR_BASE_URL --URL包含 .atlassian.net 被视为云,其他一切都被视为数据中心。覆盖 JIRA_TYPE="cloud" 或 JIRA_TYPE="datacenter".

许可证

麻省理工学院

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Zephyr MCP server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Zephyr MCP server 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Zephyr MCP server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zephyr MCP server 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Zephyr MCP server 能提供哪些能力?

资料显示约 12 个工具;能力标签包括 测试管理、TypeScript、API集成。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。