About Zephyr MCP Server
Zephyr MCP Server connects to Zephyr Scale and retrieves test cases. It is intended for workflows that need to fetch cases filtered by project key or folder, with a configurable result limit.
Key features
- 01Fetch Zephyr Scale test cases
- 02Filter by project key
- 03Filter by folder ID
- 04Set maximum result count
Use cases
- 01Retrieving cases for a project
- 02Narrowing results to a folder
- 03Limiting the number of returned cases
MCP support
It exposes the `get_test_cases` tool to MCP clients, with parameters for project key, optional folder ID, and maximum results.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEZephyr MCP Server
A Model Context Protocol (MCP) server for integrating with Zephyr Scale.
Setup Instructions
-
Clone this repository:
git clone https://github.com/nandishnagaraj/zephyr-mcp-server.git cd zephyr-mcp-server -
Install dependencies:
pip install -r requirements.txt -
Configure VS Code:
- Open your VS Code settings (JSON)
- Add the following to your MCP configuration:
{ "mcpServers": { "zephyr": { "command": "python", "args": ["zephyr/zephyr.py"] } } } -
Set your Zephyr Scale API token:
- Create a
.envfile in the project root - Add your API token:
ZEPHYR_API_TOKEN=your_api_token_here - Create a
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 casesmax_results: Maximum number of test cases to return (default: 10)
- Parameters:
Contributing
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Create a new Pull Request
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.