🚀 Zephyr MCP 服务器

Zephyr MCP 服务器是一个用于与 Zephyr Scale 集成的模型上下文协议 (MCP) 服务器，能助力用户从 Zephyr Scale 获取测试用例，还可按项目密钥、文件夹 ID 过滤并限制结果数量，为测试工作提供便利。

🚀 快速开始

📦 安装指南

1. 克隆此仓库：

   git clone https://github.com/nandishnagaraj/zephyr-mcp-server.git
   cd zephyr-mcp-server
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 配置 VS Code：

   • 打开您的 VS Code 设置（JSON）
   • 将以下内容添加到您的 MCP 配置中：

   {
     "mcpServers": {
       "zephyr": {
         "command": "python",
         "args": ["zephyr/zephyr.py"]
       }
     }
   }
   

4. 设置 Zephyr Scale API 令牌：

   • 在项目根目录中创建一个 .env 文件
   • 添加您的 API 令牌：

   ZEPHYR_API_TOKEN=your_api_token_here
   

✨ 主要特性

• 从 Zephyr Scale 获取测试用例
• 按项目密钥和文件夹 ID 过滤
• 限制结果数量

💻 使用示例

基础用法

该服务器提供以下工具：

# 从 Zephyr Scale 获取测试用例
# 工具：get_test_cases
# 参数：
# - project_key：项目密钥（例如 "SM"）
# - folder_id：（可选）用于过滤测试用例的文件夹 ID
# - max_results：要返回的最大测试用例数（默认：10）

🤝 贡献指南

1. 分叉此仓库
2. 创建功能分支
3. 提交您的更改
4. 推送到分支
5. 创建新的拉取请求