Webship-js Claude Plugin (MCP Server)

A Model Context Protocol (MCP) plugin that gives Claude Code native tools for automated website testing with webship-js (Playwright + Cucumber-js).

Tools Provided

Tool	Description
webshipjs_setup	Set up a new webship-js test project
webshipjs_create_feature	Create a Gherkin .feature file
webshipjs_create_custom_step	Add custom Cucumber step definitions
webshipjs_run_tests	Run the test suite (with optional tag filter)
webshipjs_generate_report	Generate HTML report and results summary
webshipjs_list_features	List all feature files with scenario counts
webshipjs_list_steps	Reference of all available step definitions
webshipjs_update_config	Update cucumber.js configuration

Resources Provided

Resource	Description
webshipjs://steps/all	Complete step definition reference
webshipjs://tips	Critical tips and gotchas

Installation

1. Clone and install dependencies

git clone https://github.com/webship/webship-js-claude-plugin.git
cd webship-js-claude-plugin
npm install

2. Configure in Claude Code

Add to your Claude Code settings (~/.claude/settings.json or project .claude/settings.json):

{
  "mcpServers": {
    "webship-js": {
      "command": "node",
      "args": ["/path/to/webship-js-claude-plugin/src/index.js"]
    }
  }
}

Or use the Claude Code CLI:

claude mcp add webship-js node /path/to/webship-js-claude-plugin/src/index.js

Usage Examples

Once configured, Claude Code can use the tools directly:

Set up a test project

Use webshipjs_setup to create a test project at ./my-tests for https://example.com

Create a feature file

Use webshipjs_create_feature to create a login form validation test

Run tests

Use webshipjs_run_tests to run all @desktop scenarios

Get step reference

Use webshipjs_list_steps with category "form" to see form interaction steps

Requirements

• Claude Code CLI
• Node.js >= 20.0
• npm

License

MIT