MCP Zephyr

MCP运维云端

提供方 donyfs

运维云端 未标注 会话登录 社区 / 第三方 Claude DesktopClaudeVS Code

一个用于Zephyr Scale Cloud API的MCP服务器,提供测试管理功能的集成解决方案。

一句话选型结论

按资料字段整理

MCP Zephyr 属于运维云端类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude Desktop、Claude、VS Code,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权会话登录 部署方式支持远程部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 18 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

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

能力标签

支持客户端

适用场景

测试管理JavaScript本地部署API集成项目管理测试用例管理BDD测试

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

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

值得选的地方

  • 资料标注 18 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Zephyr当前 18 未标注 支持远程部署 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

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

详细介绍

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

MCP Zephyr服务器

Zephyr Scale Cloud API的全面模型上下文协议(MCP)服务器,可实现与测试管理工作流程的无缝集成。

🚀 特性

核心能力

  • 项目管理:列出并检索项目详细信息
  • 文件夹组织:创建和管理分层文件夹结构
  • 测试用例管理:为测试用例创建、读取和更新操作
  • 测试步骤管理:获取并附加测试步骤(注意:没有单独的步骤更新/删除)
  • 测试脚本管理:创建和管理BDD/Gherkin测试脚本(与步骤互斥)
  • 参考数据:测试用例配置的访问状态和优先级

🛠️ 可用工具

项目工具

  • list_projects -获取所有Zephyr集成Jira项目
  • get_project -检索详细的项目信息

文件夹工具

  • list_folders -列出具有项目/文件夹筛选功能的文件夹
  • get_folder -获取详细的文件夹信息
  • create_folder -创建具有可选父层次结构的新文件夹

测试用例工具

  • list_test_cases -列出带有筛选功能的测试用例(项目、文件夹)
  • get_test_case -检索详细的测试用例信息
  • create_test_case -创建具有完整配置的新测试用例
  • update_test_case -更新现有测试用例

测试步骤工具

  • get_test_steps -获取测试步骤(分页,最多100个项目)
  • get_all_test_steps -获取所有测试步骤(自动分页)
  • append_test_steps -在现有序列中添加新步骤(每个请求最多100个)

测试脚本工具

  • get_test_script -获取BDD/Gherkin测试脚本
  • create_test_script -创建/更新测试脚本(删除现有步骤)
  • create_bdd_test_script -BDD脚本创建和验证的助手

参考数据工具

  • list_statuses -获取所有可用状态(草稿、就绪、已批准等)
  • list_priorities -获取所有可用优先级(高、中、低等)
  • get_reference_data -在一次通话中获取状态和优先级

📋 先决条件

  • Node.js 18.0.0或更高版本
  • 具有API访问权限的Zephyr Scale云帐户
  • 启用Zephyr集成的Jira项目

🔧 安装

  1. 克隆或下载此存储库

  2. 安装依赖项:```bash
    npm install


1. **设置环境变量**:```bash
cp .env.example .env

编辑 .env 并添加您的Zephyr API令牌:```env
ZEPHYR_API_TOKEN=your_bearer_token_here
ZEPHYR_REGION=us


## 🔑 获取您的API代币

1. 登录您的Jira Cloud实例
1. 点击左下角的个人资料图片
1. 选择“Zephyr API密钥”
1. 生成新的API令牌
1. 将令牌复制到您的 `.env` 文件

## 🚀 运行服务器

### 发展模式```bash
npm run dev

生产模式```bash

npm start


### 使用MCP客户端```bash
# Start the server
npm start

# In another terminal, use with your MCP client
# Configuration will be automatically discovered

🔌 使用此MCP服务器

此软件包是一个通过stdio进行通信的MCP服务器。它被设计为由MCP客户端(例如,VS Code MCP扩展或Claude Desktop)启动。如果直接运行它,它将显示为“空闲”,因为它在stdin上等待MCP协议消息。

VS代码MCP扩展

创建或更新您的MCP配置文件(例如.vcode/MCP.json)以包含此服务器:```jsonc
{
"servers": {
"zephyr": {
"type": "stdio",
"command": "mcp-zephyr",
"env": {
"ZEPHYR_API_TOKEN": "YOUR_TOKEN_HERE",
"ZEPHYR_REGION": "us"
}
}
},
"inputs": []
}


然后从MCP扩展UI启动服务器。它应该保持在运行状态,并准备好接收工具调用。

### 克劳德桌面(MCP)

在Claude Desktop MCP设置中添加服务器条目:```jsonc
{
"mcpServers": {
"zephyr": {
"command": "mcp-zephyr",
"env": {
"ZEPHYR_API_TOKEN": "YOUR_TOKEN_HERE",
"ZEPHYR_REGION": "us"
}
}
}
}

保存后,重新启动Claude Desktop。服务器将可用于聊天中的工具使用。

本地CLI(用于调试)

如果要查看日志,请在stderr可见的情况下运行:```bash
mcp-zephyr 2> server.log


服务器日志被写入stderr,以避免干扰stdout上的MCP协议消息。

## 🧰 测试单个工具

对于开发和调试,您可以使用 `test-tools.js` 脚本:

### 列出可用工具```bash
node test-tools.js --list

测试工具```bash

Simple tool without arguments

node test-tools.js list_projects

Tool with arguments (pass JSON)

node test-tools.js list_projects '{"maxResults": 10}'

Get specific project

node test-tools.js get_project '{"projectId": "PROJ1"}'

Create a test case

node test-tools.js create_test_case '{"name": "Login Test", "projectKey": "PROJ"}'

List test cases with filtering

node test-tools.js list_test_cases '{"projectKey": "PROJ", "maxResults": 5}'

Get reference data

node test-tools.js get_reference_data


**备注**:确保你的 `.env` 文件配置为 `ZEPHYR_API_TOKEN` 在运行测试工具之前。

## 📝 用法示例

### 基本项目操作```javascript
// List all projects
{
"tool": "list_projects",
"arguments": {
"maxResults": 50
}
}

// Get specific project
{
"tool": "get_project",
"arguments": {
"projectId": "PROJ"
}
}

文件夹管理```javascript

// Create a folder
{
"tool": "create_folder",
"arguments": {
"name": "Smoke Tests",
"projectKey": "PROJ",
"parentFolderId": "123"
}
}


### 测试用例创建```javascript
// Create a comprehensive test case
{
"tool": "create_test_case",
"arguments": {
"name": "User Login Test",
"projectKey": "PROJ",
"description": "Verify user can log in with valid credentials",
"priorityName": "High",
"statusName": "Ready",
"folderId": "123",
"component": "Authentication",
"labels": ["smoke", "regression"],
"objective": "Verify login functionality",
"precondition": "User exists in system",
"estimatedTime": 5
}
}

测试步骤管理```javascript

// Append test steps
{
"tool": "append_test_steps",
"arguments": {
"testCaseKey": "PROJ-T1",
"steps": [
{
"description": "Navigate to login page",
"expectedResult": "Login page is displayed"
},
{
"description": "Enter valid username and password",
"expectedResult": "Credentials are accepted"
},
{
"description": "Click login button",
"expectedResult": "User is logged in and redirected to dashboard"
}
]
}
}


### BDD测试脚本创建```javascript
// Create BDD script with helper
{
"tool": "create_bdd_test_script",
"arguments": {
"testCaseKey": "PROJ-T2",
"feature": "User Authentication",
"scenario": "Successful login with valid credentials",
"steps": [
"Given I am on the login page",
"And I have valid user credentials",
"When I enter my username and password",
"And I click the login button",
"Then I should be redirected to the dashboard",
"And I should see my username displayed"
]
}
}

获取参考数据```javascript

// Get all statuses and priorities
{
"tool": "get_reference_data"
}


## ⚠️ 重要说明

### 测试步骤与测试脚本

- **互斥**:一个测试用例可以有测试步骤或测试脚本,而不是两者都有
- **脚本创建警告**:创建测试脚本会自动删除现有的测试步骤
- **步骤限制**:单个测试步骤不能更新或删除,只能批量附加

### API约束

- **分页**:大多数端点支持分页(每个请求最多1000个项目)
- **步骤限制**:每个请求最多可以添加100个测试步骤
- **速率限制**:遵守Zephyr Cloud API费率限制
- **区域支持**:通过配置支持美国和欧盟地区

### 数据格式

- **测试用例密钥**:格式 `[A-Z]+-T[0-9]+` (例如。, `PROJ-T1`)
- **项目密钥**:格式 `A-Z+` (例如。, `PROJ`, `PROJ123`)
- **文件夹ID**:数字字符串(例如。, `"123"`)
- **测试脚本**:Gherkin格式用于BDD,纯文本用于简单脚本

## 🧪 测试```bash
# Run tests
npm test

# Run tests in watch mode
npm run test:watch

# Run with coverage
npm test -- --coverage

🔍 代码质量```bash

Run linter

npm run lint

Fix linting issues

npm run lint:fix


## 🏗️ 项目结构```
mcp-zephyr/
├── src/
│   ├── config.js              # Configuration management
│   ├── zephyr-client.js       # API client with error handling
│   ├── index.js               # Main MCP server entry point
│   └── tools/                 # MCP tool implementations
│       ├── project-tools.js
│       ├── folder-tools.js
│       ├── test-case-tools.js
│       ├── test-steps-tools.js
│       ├── test-script-tools.js
│       └── reference-data-tools.js
├── tests/                     # Unit tests
│   ├── setup.js
│   ├── config.test.js
│   ├── zephyr-client.test.js
│   └── tools/
│       └── project-tools.test.js
├── .env.example               # Environment template
├── package.json               # Dependencies and scripts
├── eslint.config.js           # ESLint configuration
├── jest.config.js             # Jest test configuration
└── README.md                  # This file

🔌 MCP集成

此服务器实现了模型上下文协议规范:

  • 工具发现:通过自动工具列表 ListToolsRequestSchema
  • 工具执行:通过标准化工具调用 CallToolRequestSchema
  • 错误处理:所有操作的一致错误响应
  • JSON 模式:所有工具参数的输入验证

🐛 故障排除

常见问题

  1. “ZEPHYR_API_TOKEN环境变量是必需的”
  • 确保您已创建 .env 带有有效API令牌的文件
  • 检查令牌是否未过期
  1. “testCaseKey格式无效”
  • 测试用例密钥必须与模式匹配 [A-Z]+-T[0-9]+
  • 示例: PROJ-T1, PROJECT123-T456
  1. “请求超时”
  • 检查您的互联网连接
  • 尝试减少 maxResults 用于大型请求的参数
  1. “未找到测试用例”
  • 验证Zephyr实例中是否存在测试用例密钥
  • 确保您拥有适当的项目权限

调试模式

通过设置环境变量启用调试日志记录:bash DEBUG=* npm start

📄 许可证

MIT许可证-有关详细信息,请参阅许可证文件。

🤝 贡献

  1. 克隆该仓库
  2. 创建要素分支
  3. 进行更改
  4. 添加新功能的测试
  5. 运行测试套件
  6. 提交拉取请求

🆘 支持

  • Zephyr文档: Zephyr Scale Cloud API文档
  • MCP规范: 模型上下文协议
  • 问题:通过GitHub Issues报告bug

常见问题

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

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

MCP Zephyr 怎么在 Claude Desktop、Claude、VS Code 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Zephyr 收费吗?

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

MCP Zephyr 需要 API Key 吗?

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

MCP Zephyr 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Zephyr 能提供哪些能力?

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

MCP Zephyr 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

MCP Zephyr 是本地还是远程?

它是远程端点,连服务地址即可。

热门专题

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

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