Zephyr MCP Server
About
A Model Context Protocol (MCP) server for integrating with Zephyr Scale. It allows developers to fetch test cases programmatically using an MCP‑compatible client (e.g., VS Code).
Details
- Author
- nandishnagaraj
- Downloads
- 513
- Categories
- Other
Jump to
- Fetch test cases from Zephyr Scale
- Filter by project key and folder ID
- Limit number of results (default 10)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Zephyr MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install dependencies, then configure VS Code MCP settings with the command python and arguments ["zephyr/zephyr.py"]. Set your Zephyr Scale API token in a .env file. The server exposes the get_test_cases tool that accepts project_key, optional folder_id, and max_results.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"zephyr mcp server": {
"zephyr": {
"command": "python",
"args": [
"zephyr/zephyr.py"
]
}
}
}
}McpServers
{
"zephyr": {
"command": "python",
"args": [
"zephyr/zephyr.py"
]
}
}Zephyr MCP Server
A Model Context Protocol (MCP) server for integrating with Zephyr Scale.
Setup Instructions
1. Clone this repository:
git clone https://github.com/nandishnagaraj/zephyr-mcp-server.git
cd zephyr-mcp-server
2. Install dependencies:
pip install -r requirements.txt
3. Configure VS Code:
- Open your VS Code settings (JSON)
- Add the following to your MCP configuration:
{
"mcpServers": {
"zephyr": {
"command": "python",
"args": ["zephyr/zephyr.py"]
}
}
}
4. Set your Zephyr Scale API token:
- Create a .env file in the project root
- Add your API token:
ZEPHYR_API_TOKEN=your_api_token_here
Features
- Fetch test cases from Zephyr Scale
- Filter by project key and folder ID
- Limit number of results
Usage
The server provides the following tools:
- get_test_cases: Fetch test cases from Zephyr Scale
- Parameters:
- project_key: Project key (e.g., "SM")
- folder_id: (Optional) Folder ID to filter test cases
- max_results: Maximum number of test cases to return (default: 10)
Contributing
1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
