Provides LLM access to the Cucumber Studio testing platform for managing and executing tests.
Vibe Coded with Claude Code and Pu-Er 🍵
A Model Context Protocol (MCP) server that provides LLM access to Cucumber Studio's testing platform. This server enables AI assistants to retrieve test scenarios, action words, test runs, and project information from Cucumber Studio.
The easiest way to use this MCP server is as a Desktop Extension:
.dxt
file from the releases page (automatically built from each release)The extension will automatically handle the MCP server setup and communication.
Run directly with npx (no installation required):
npx cucumberstudio-mcp
Set your environment variables first:
export CUCUMBERSTUDIO_ACCESS_TOKEN="your_token"
export CUCUMBERSTUDIO_CLIENT_ID="your_client_id"
export CUCUMBERSTUDIO_UID="your_uid"
git clone https://github.com/HeroSizy/cucumberstudio-mcp.git
cd cucumberstudio-mcp
npm install
cp .env.example .env
# Edit .env with your Cucumber Studio API credentials
npm run build
Run the official Docker image from Docker Hub:
# With environment file
docker run --env-file .env herosizy/cucumberstudio-mcp
# With environment variables
docker run -e CUCUMBERSTUDIO_ACCESS_TOKEN=your_token \
-e CUCUMBERSTUDIO_CLIENT_ID=your_client_id \
-e CUCUMBERSTUDIO_UID=your_uid \
herosizy/cucumberstudio-mcp
cp .env.example .env
# Edit .env with your Cucumber Studio API credentials
version: '3.8'
services:
cucumberstudio-mcp:
image: herosizy/cucumberstudio-mcp
env_file:
- .env
restart: unless-stopped
ports:
- "${MCP_PORT:-3000}:3000"
docker-compose up
npm run docker:build
npm run docker:run
The Docker setup includes health checks and automatic restarts for production use. The multi-stage build process creates optimized production images with only runtime dependencies (~150MB).
The server requires Cucumber Studio API credentials. Get these from your Cucumber Studio account settings:
CUCUMBERSTUDIO_ACCESS_TOKEN
- Your API access tokenCUCUMBERSTUDIO_CLIENT_ID
- Your client IDCUCUMBERSTUDIO_UID
- Your user IDCUCUMBERSTUDIO_BASE_URL
- API base URL (default: https://studio.cucumberstudio.com/api)MCP_TRANSPORT
- Transport type: stdio
(default), http
, or streamable-http
MCP_PORT
- HTTP transport port (default: 3000)MCP_HOST
- HTTP transport host (default: 0.0.0.0)MCP_CORS_ORIGIN
- CORS origin setting (default: true)LOG_LEVEL
- Log level: error
, warn
, info
, debug
, trace
(default: info)LOG_API_RESPONSES
- Log Cucumber Studio API responses (default: false)LOG_REQUEST_BODIES
- Log API request bodies for debugging (default: false)LOG_RESPONSE_BODIES
- Log API response bodies for debugging (default: false)LOG_TRANSPORT
- Logging output: console
, stderr
, file
, none
(default: stderr)LOG_FILE
- Log file path (required if LOG_TRANSPORT=file)The server supports both STDIO and HTTP transports:
# Development
npm run dev
# Production
npm start
# Development
npm run dev:http
# Production
npm run start:http
Import the .dxt
extension file directly into your compatible AI desktop application. The extension handles all configuration through its settings interface.
For manual MCP client configuration:
{
"mcpServers": {
"cucumberstudio": {
"command": "npx",
"args": ["cucumberstudio-mcp"],
"env": {
"CUCUMBERSTUDIO_ACCESS_TOKEN": "your_token",
"CUCUMBERSTUDIO_CLIENT_ID": "your_client_id",
"CUCUMBERSTUDIO_UID": "your_uid"
}
}
}
}
{
"mcpServers": {
"cucumberstudio": {
"command": "node",
"args": ["/path/to/cucumberstudio-mcp/build/index.js"],
"env": {
"CUCUMBERSTUDIO_ACCESS_TOKEN": "your_token",
"CUCUMBERSTUDIO_CLIENT_ID": "your_client_id",
"CUCUMBERSTUDIO_UID": "your_uid"
}
}
}
}
{
"mcpServers": {
"cucumberstudio": {
"command": "docker",
"args": ["run", "--rm", "-i", "--env-file", "/path/to/.env", "herosizy/cucumberstudio-mcp"]
}
}
}
{
"mcpServers": {
"cucumberstudio": {
"command": "docker",
"args": ["run", "--rm", "-i", "--env-file", "/path/to/.env", "cucumberstudio-mcp"]
}
}
}
cucumberstudio_list_projects
- List all accessible projectscucumberstudio_get_project
- Get detailed project informationcucumberstudio_list_scenarios
- List scenarios in a projectcucumberstudio_get_scenario
- Get detailed scenario informationcucumberstudio_find_scenarios_by_tags
- Find scenarios by tagscucumberstudio_list_action_words
- List reusable action wordscucumberstudio_get_action_word
- Get detailed action word informationcucumberstudio_find_action_words_by_tags
- Find action words by tagscucumberstudio_list_test_runs
- List test runscucumberstudio_get_test_run
- Get detailed test run informationcucumberstudio_get_test_executions
- Get individual test resultscucumberstudio_list_builds
- List buildscucumberstudio_get_build
- Get build detailscucumberstudio_list_execution_environments
- List execution environmentsThe server supports hot reload for rapid development:
# STDIO transport with hot reload
npm run dev
# HTTP transport with hot reload
npm run dev:http
Files are automatically recompiled and the server restarts when changes are detected.
# Install dependencies
npm install
# Run type checking
npm run typecheck
# Run linting
npm run lint
# Build for production
npm run build
# Run tests
npm test
# Run tests in watch mode
npm run test:watch
# Run tests with coverage (82%+ coverage)
npm run test:coverage
# Run tests with UI
npm run test:ui
# Production build (default) - optimized for size, no .d.ts/.js.map files
npm run build
# Development build - includes source maps and type declarations for debugging
npm run build:dev
# Validate manifest.json
npm run dxt:validate
# Build complete DXT extension for local testing (optimized production build)
npm run dxt:build
# Check info about built extension
npm run dxt:info
# Clean up build artifacts
npm run dxt:clean
The server is built with a modular, production-ready architecture:
The project includes comprehensive test coverage:
# Run all tests
npm test
# Run tests with coverage report
npm run test:coverage
# Run tests in watch mode (for development)
npm run test:watch
Test coverage includes:
This project uses automated releases via GitHub Actions. When a version tag is pushed, it automatically:
npx cucumberstudio-mcp
package.json
:npm version patch|minor|major
git push origin --tags
For automated publishing, the following secrets must be configured in the GitHub repository:
NPM_TOKEN
- NPM authentication tokenDOCKER_USERNAME
- Docker Hub usernameDOCKER_PASSWORD
- Docker Hub password or access tokennpm test
MIT License - see LICENSE file for details
A tool for interacting with Jenkins CI/CD servers, requiring environment variables for configuration.
An AI agent for the Playwright MCP server, enabling automated web testing and interaction.
Make your AI agent speak every language on the planet, using Lingo.dev Localization Engine.
AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform
Interact with the Unstructured API to manage data sources, destinations, workflows, and jobs.
Enables IDEs like Cursor and Windsurf to analyze large codebases using Gemini's 1M context window.
Integrates with Language Server Protocol (LSP) to provide features like code completion, diagnostics, and hover information.
Enable your code gen agents to create & run 0-config end-to-end tests against new code changes in remote browsers via the Debugg AI testing platform.
A proof-of-concept MCP server built with Node.js and TypeScript, compatible with Claude Desktop.
Empowers LLMs with real-time network traffic analysis using tshark. Requires Wireshark's tshark to be installed.