@marianarocha/zephyr-scale-mcp
v0.2.3
Published
Internal MCP server for Zephyr Scale test management (Cloud & Data Center)
Readme
Internal Zephyr Scale MCP Server
This is an internal forked MCP server for Zephyr Scale (Jira Cloud & Data Center) used by the BCS platform. It provides tools for test case management, test runs, and folder operations with robust, ID-based folder filtering and is now published as the npm package @marianarocha/zephyr-scale-mcp.
Key differences vs upstream:
- Published as a lightweight npm package that can be executed via
npx(no need to bundle the source inside consumers) - Folder utilities with exact folder matching by folder ID
- include_subfolders flag for folder queries
Build
- npm install
- npm run build
Publish
Use the following steps to build and publish a new version to npm (requires access to the @marianarocha scope):
npm login
npm version <patch|minor|major>
npm run build
npm publish --access publicRun
npx -y @marianarocha/zephyr-scale-mcp(stdio transport)- or
node build/index.jswhen running from a cloned repository
Environment
- ZEPHYR_BASE_URL (required)
- ZEPHYR_API_KEY (required)
- Optional advanced tuning:
ZEPHYR_METADATA_CACHE_TTL_MS– cache TTL for status/priority catalogs (default 5 minutes)ZEPHYR_AUTOMATED_STATUS_KEYWORDS– comma-separated keywords that should count as automated (default:automated,automation in progress,automatizado,em automação)ZEPHYR_MANUAL_STATUS_KEYWORDS– comma-separated keywords that should count as manual (default keeps legacy values such asmanual,deploy,aprovado,rascunho)
Metadata-driven automation
- The MCP now loads Zephyr status/priority catalogs at runtime and exposes them as resources:
zephyr://metadata/statuseszephyr://metadata/prioritieszephyr://metadata/automation_rules
get_test_caseandsearch_test_cases_by_folderresponses are enriched with:statusName,priorityName, andautomationLabelautomationSummaryaggregates identical to the previous Python-side enhancement
- Python consumers no longer need
ZephyrStatusMappingUseCase; automation logic lives inside the MCP so downstream services can just forward the enriched payloads.
