Zephyr Scale MCP Server Ed54f6f3

MCP办公协作

提供方 ArtyMaximus

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

Zephyr Scale MCP Server是一个用于管理Zephyr Scale Data Center中测试用例的服务器,支持STEP_BY_STEP、PLAIN_TEXT和BDD格式的测试脚本,提供完整的测试生命周期管理功能。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

测试管理TypeScript本地部署ZephyrScaleJira集成测试自动化BDD测试

安装与配置

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

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

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

值得选的地方

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

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zephyr Scale MCP Server Ed54f6f3当前 19 未标注 未标注 无 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

服务器档案

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

详细介绍

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

Zephyr Scale MCP Server

Model Context Protocol (MCP) сервер для управления тест-кейсами в Zephyr Scale Data Center. Создавайте, читайте и управляйте тест-кейсами через Atlassian REST API с поддержкой STEP_BY_STEP, PLAIN_TEXT и BDD форматов.

Особенности

  • ✅ Поддержка Zephyr Scale Data Center: Работает с локально развернутыми экземплярами Jira с Zephyr Scale
  • ✅ Три типа тест-скриптов: STEP_BY_STEP, PLAIN_TEXT и BDD с автоматической конвертацией
  • ✅ Управление полным жизненным циклом: Создание, чтение, обновление, удаление тест-кейсов, управление тест-ранами и папками
  • ✅ Система ресурсов: Доступ к живым данным из Zephyr через URI (zephyr://testcase/KEY) для использования в качестве шаблонов
  • ✅ Загрузка изображений: Автоматическая загрузка изображений из markdown и встраивание в шаги тест-кейсов
  • ✅ Умный поиск папок: Автоматическое предложение подходящих папок на основе описания тест-кейса
  • ✅ Конвертация Markdown в HTML: Автоматическое преобразование markdown-разметки для корректного отображения в Zephyr Scale

Установка и настройка

Использование через npx (рекомендуется)

Настройте ваш MCP клиент следующим образом:```json
{
"mcpServers": {
"zephyr-server": {
"command": "npx",
"args": ["@artymaximus/zephyr-scale-mcp-server@latest"],
"env": {
"ZEPHYR_BASE_URL": "https://your-jira-server.com",
"ZEPHYR_API_KEY": "your-api-token"
}
}
}
}


### Локальная установка

1. Клонируйте репозиторий:```bash
git clone <your-repo-url>
cd zephyr-scale-mcp-server
  1. Установите зависимости:```bash
    npm install

3. Соберите проект:```bash
npm run build
  1. Настройте переменные окружения:```bash
    export ZEPHYR_BASE_URL="https://your-jira-server.com"
    export ZEPHYR_API_KEY="your-api-token"

5. Запустите сервер:```bash
npm start

Совместимость

Сервер протестирован и работает со следующими версиями:

  • Jira Data Center: 9.12.14
  • Zephyr Scale: 11.7.1-jira9

> Примечание: Сервер разработан для работы с Zephyr Scale Data Center. Совместимость с другими версиями не гарантируется.

Аутентификация

Сервер работает только с Zephyr Scale Data Center. Для аутентификации требуется:

  • ZEPHYR_BASE_URL: URL вашего Jira сервера (например, https://jira.skyeng.link)
  • ZEPHYR_API_KEY: API токен из настроек профиля Jira

Получение API токена

  1. Войдите в Jira
  2. Перейдите в Account Settings → Security → API Tokens
  3. Создайте новый токен
  4. Используйте его в переменной окружения ZEPHYR_API_KEY

Основные концепции

Типы тест-скриптов

Сервер поддерживает три типа тест-скриптов:

STEP_BY_STEP

Используйте, когда:
- Нужна четкая структура с отдельными полями для каждого шага
- Требуется указать testData (тестовые данные) отдельно от описания
- Нужны ссылки на другие тест-кейсы через testCaseKey
- Шаги простые и не требуют сложного форматирования

Структура:```json
{
"type": "STEP_BY_STEP",
"steps": [
{
"description": "Описание действия",
"testData": "Конкретные данные для теста (URL, параметры, значения)",
"expectedResult": "Ожидаемый результат",
"testCaseKey": "PROJ-T123" // опционально, ссылка на другой тест-кейс
}
]
}


**Особенности:**
- Каждый шаг - отдельный объект с четкой структурой
- Поддерживает поле `testData` для входных данных
- Поддерживает `testCaseKey` для ссылок на другие тест-кейсы
- Все поля обрабатываются независимо

#### PLAIN_TEXT

**Используйте, когда:**
- Тест-кейс содержит много текста с markdown-разметкой (заголовки, списки, изображения)
- Нужна гибкость в форматировании описания шагов
- Не требуется отдельное поле `testData` (все данные в описании)
- Шаги разделяются простыми разделителями

**Структура:**```
Шаг 1: Описание первого действия
Может содержать markdown: **жирный текст**, списки, заголовки
**Ожидаемый результат:** Результат первого шага

---

Шаг 2: Описание второго действия
![Изображение](url)
**Ожидаемый результат:** Результат второго шага

---

Шаг 3: Описание третьего действия
**Ожидаемый результат:** Результат третьего шага

Особенности:
- Разделители: --- или *** на отдельной строке
- Автоматически конвертируется в STEP_BY_STEP на сервере
- Извлекает "Ожидаемый результат:" из текста (ищет **Ожидаемый результат:**)
- НЕ поддерживает отдельное поле testData - все данные должны быть в описании
- Если нет разделителей, весь текст становится одним шагом
- Поддерживает markdown-разметку (заголовки, списки, изображения)

Ключевое отличие от STEP_BY_STEP:
- PLAIN_TEXT → автоматическая конвертация, нет testData, простой текст с разделителями
- STEP_BY_STEP → структурированный JSON, есть testData, четкие поля

BDD

Используйте, когда:
- Тест описывает поведение системы (Given/When/Then)
- Нужны acceptance criteria в формате Gherkin
- Тест написан в стиле Behavior Driven Development

Структура:```
Feature: Описание фичи

Scenario: Описание сценария
Given начальное условие
When выполняется действие
Then ожидается результат


**Особенности:**
- Автоматическая конвертация markdown-стиля BDD в Gherkin
- Поддерживает ключевые слова: Given, When, Then, And

#### Сравнительная таблица

| Критерий | STEP_BY_STEP | PLAIN_TEXT | BDD |
|----------|--------------|------------|-----|
| **Формат данных** | Структурированный JSON | Простой текст | Текст (Gherkin) |
| **Поле testData** | ✅ Поддерживается | ❌ Не поддерживается | ❌ Не поддерживается |
| **Ссылки на другие тесты** | ✅ testCaseKey | ❌ Не поддерживается | ❌ Не поддерживается |
| **Markdown разметка** | ✅ Ограниченная | ✅ Полная поддержка | ✅ Ограниченная |
| **Разделители шагов** | Не нужны (массив) | `---` или `***` | Не нужны |
| **Автоконвертация** | Нет | ✅ В STEP_BY_STEP | ✅ В Gherkin |
| **Когда использовать** | Простые структурированные шаги | Сложное форматирование, много текста | Поведенческие тесты |

**Рекомендация для LLM:**
- Выбирайте **STEP_BY_STEP**, если нужны отдельные поля `testData` или ссылки на другие тесты
- Выбирайте **PLAIN_TEXT**, если описание шагов содержит много markdown-разметки (заголовки, списки, изображения) и не требуется `testData`
- Выбирайте **BDD**, если тест описывает поведение системы в формате Given/When/Then

### Система ресурсов

Сервер предоставляет доступ к различным ресурсам через URI схемы:

- `zephyr://testcase/YOUR-TEST-CASE-KEY`: Получить реальные данные тест-кейса из Zephyr для использования в качестве шаблона
- `file:///absolute/path/to/your/file.json`: Чтение пользовательских файлов

## Справочник инструментов

### Управление тест-кейсами

- `get_test_case`: Получить детальную информацию о тест-кейсе
- `create_test_case`: Создать тест-кейс с поддержкой STEP_BY_STEP, PLAIN_TEXT или BDD
- `delete_test_case`: Удалить тест-кейс
- `update_test_case_bdd`: Обновить существующий тест-кейс с BDD контентом
- `update_test_case_step`: Обновить конкретный шаг в STEP_BY_STEP тест-кейсе

### Управление тест-ранами

- `create_test_run`: Создать новый тест-ран
- `get_test_run`: Получить информацию о тест-ране
- `get_test_run_cases`: Получить список тест-кейсов в тест-ране
- `add_test_cases_to_run`: Добавить тест-кейсы в существующий тест-ран
- `get_test_execution`: Получить детальную информацию о выполнении теста

### Управление папками

- `create_folder`: Создать новую папку в Zephyr Scale
- `delete_folder`: Удалить папку по её ID (используйте `get_folder_tree` или `get_folder_full_structure` для получения ID папки)
- `get_folder_tree`: Получить полную структуру папок проекта
- `get_folder_full_structure`: Получить полную структуру вложенных папок для конкретной корневой папки
- `suggest_folder_for_test_case`: Предложить подходящую папку на основе описания тест-кейса

### Управление проектами

- `get_project_info`: Получить информацию о проекте, включая projectId
- `get_all_projects`: Получить список всех проектов

### Поиск

- `search_test_cases_by_folder`: Поиск тест-кейсов в конкретной папке

### Загрузка изображений

- `upload_image`: Загрузить изображение в Zephyr Scale и получить HTML тег для встраивания в шаги тест-кейсов

## Примеры использования

### Создание STEP_BY_STEP тест-кейса

Используйте, когда нужны отдельные поля для тестовых данных:```json
{
  "project_key": "PROJ",
  "name": "User Login Test",
  "test_script": {
    "type": "STEP_BY_STEP",
    "steps": [
      {
        "description": "Открыть страницу входа",
        "testData": "URL: https://example.com/login",
        "expectedResult": "Страница входа отображается"
      },
      {
        "description": "Ввести учетные данные",
        "testData": "Username: testuser@example.com\nPassword: password123",
        "expectedResult": "Поля заполнены корректно"
      },
      {
        "description": "Нажать кнопку входа",
        "testData": "",
        "expectedResult": "Пользователь авторизован, выполнен переход на главную страницу"
      }
    ]
  }
}

Преимущества: Четкое разделение описания, тестовых данных и ожидаемого результата.

Создание PLAIN_TEXT тест-кейса

Используйте, когда нужно сложное форматирование с markdown:```json
{
"project_key": "PROJ",
"name": "Complex Test with Markdown",
"test_script": {
"type": "PLAIN_TEXT",
"text": "# Шаг 1: Настройка окружения\n\nВыполнить следующие действия:\n- Проверить доступность сервера\n- Установить необходимые зависимости\n- Настроить переменные окружения\n\nОжидаемый результат: Окружение готово к тестированию\n\n---\n\n# Шаг 2: Выполнение основного действия\n\nОткрыть приложение и выполнить основную операцию.\n\n\n\nОжидаемый результат: Операция выполнена успешно, отображается результат\n\n---\n\n# Шаг 3: Проверка результатов\n\nПроверить:\n1. Корректность данных\n2. Отображение в интерфейсе\n3. Запись в базе данных\n\nОжидаемый результат: Все проверки пройдены"
}
}


**Преимущества:** Гибкое форматирование, поддержка markdown, автоматическая конвертация в STEP_BY_STEP.

### Создание BDD тест-кейса```json
{
  "project_key": "PROJ",
  "name": "User Authentication",
  "test_script": {
    "type": "BDD",
    "text": "Feature: User Login\n\nScenario: Valid user login\n  Given a user with valid credentials\n  When the user attempts to log in\n  Then the user should be authenticated successfully"
  }
}

Примечание: Сервер автоматически конвертирует markdown-стиль BDD в правильный формат Gherkin.

Использование существующего тест-кейса как шаблона

  1. Получите существующий тест-кейс: zephyr://testcase/PROJ-T123
  2. Скопируйте его структуру (особенно customFields и folder)
  3. Создайте новый тест-кейс, используя ту же конфигурацию проекта

Создание тест-кейса с изображениями

Изображения в markdown формате автоматически загружаются и встраиваются:```json
{
"project_key": "PROJ",
"name": "Test with Screenshot",
"test_script": {
"type": "STEP_BY_STEP",
"steps": [
{
"description": "# Шаг 1: Открыть страницу\n\nПереход на главную страницу\n\n",
"testData": "URL: https://example.com",
"expectedResult": "Страница загружена успешно"
}
]
}
}


### Создание тест-рана```json
{
  "project_key": "PROJ",
  "name": "Sprint 1 Test Run",
  "test_case_keys": ["PROJ-T123", "PROJ-T124", "PROJ-T125"],
  "environment": "Production"
}

Поиск подходящей папки```json

{
"project_key": "PROJ",
"test_case_description": "Авторизация пользователя через API"
}
```

Сервер автоматически найдет наиболее подходящую папку на основе описания.

Конвертация Markdown

Сервер автоматически конвертирует markdown-разметку в HTML для корректного отображения в Zephyr Scale:

  • Заголовки (#, ##, ###) → HTML заголовки
  • Жирный текст → ``
  • Курсив → ``
  • Код → ``
  • Списки → HTML списки
  • Изображения `` → автоматическая загрузка и встраивание

Важно: Технические термины с подчеркиваниями (например, english_adult_not_native_speaker_course_it) защищены от конвертации в курсив.

Лицензия

MIT

常见问题

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

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

Zephyr Scale MCP Server Ed54f6f3 怎么在客户端里配置?

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

Zephyr Scale MCP Server Ed54f6f3 收费吗?

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

Zephyr Scale MCP Server Ed54f6f3 需要 API Key 吗?

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

Zephyr Scale MCP Server Ed54f6f3 能提供哪些能力?

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

热门专题

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

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