@uuv/mcp-server 0.1.2 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +51 -13
  2. package/dist/CHANGELOG.md +7 -0
  3. package/dist/README.md +51 -13
  4. package/dist/package.json +3 -3
  5. package/package.json +1 -1
package/README.md CHANGED
@@ -2,11 +2,16 @@
2
2
 
3
3
  This library is an MCP (Model Context Protocol) server for UUV - a solution to facilitate the writing and execution of E2E tests understandable by any human being(English or French) using cucumber(BDD) and cypress or playwright.
4
4
 
5
+ ## Requirements
6
+ - Node.js 20
7
+ - Opencode, Claude Desktop, Goose or any other MCP client
8
+ - [Playwright MCP Server](https://github.com/microsoft/playwright-mcp)
9
+
5
10
  ## Exposed MCP Tools
6
11
 
7
12
  This MCP server exposes the following tools:
8
13
 
9
- ### 1. retrieve_prompt
14
+ ### retrieve_prompt
10
15
  - **Description**: Retrieve a uuv prompt template for a coding agent based on a prompt name and arguments.
11
16
  - **Input Schema**:
12
17
  - `promptName` (enum): Either "generate_table" or "generate_role_and_name"
@@ -15,40 +20,73 @@ This MCP server exposes the following tools:
15
20
  - `accessibleName` (string, optional): Accessible name
16
21
  - `accessibleRole` (string, optional): Accessible role
17
22
 
18
- ### 2. available_sentences
23
+ ### available_sentences
19
24
  - **Description**: List all available UUV test sentences/phrases in Gherkin format.
20
25
  - **Input Schema**:
21
26
  - `category` (enum, optional): Filters sentences by action type (general, keyboard, click, contains, type, checkable)
22
27
  - `role` (string, optional): Filters sentences related to an accessible role
23
28
 
24
- ### 3. generate_role_and_name
29
+ ### generate_role_and_name
25
30
  - **Description**: Generate a complete UUV test scenario (Gherkin format) to verify the presence of an element with specified accessible name and role.
26
31
  - **Input Schema**:
27
32
  - `baseUrl` (string): The base URL of the page where the element is located
28
33
  - `accessibleName` (string): Accessible name of the element
29
34
  - `accessibleRole` (string): Accessible role of the element
30
35
 
31
- ### 4. generate_table
36
+ ### generate_table
32
37
  - **Description**: Generate a complete UUV test scenario (Gherkin format) to verify the presence and content of html table, grid or treegrid.
33
38
  - **Input Schema**:
34
39
  - `baseUrl` (string): The base URL of the page where the table/grid/treegrid is located
35
40
  - `innerHtmlFilePath` (string): File path containing the raw innerHTML content
36
41
 
37
- ## Command
38
- Add the following command to execute **UUV MCP Server** `npx @uuv/mcp-server`.
42
+ ## Getting started
43
+
44
+ First, install the UUV MCP server with your client.
45
+
46
+ **Standard config** works in most of the tools:
47
+
48
+ ```js
49
+ {
50
+ "mcpServers": {
51
+ "uuv": {
52
+ "command": "npx",
53
+ "args": [
54
+ "@uuv/mcp-server@latest"
55
+ ]
56
+ }
57
+ }
58
+ }
59
+ ```
60
+
61
+ <summary>opencode</summary>
62
+
63
+ Follow the MCP Servers [documentation](https://opencode.ai/docs/mcp-servers/). For example in `~/.config/opencode/opencode.json`:
39
64
 
40
- ### Opencode configuration example (opencode.json)
41
65
  ```json
42
- ...
66
+ {
67
+ "$schema": "https://opencode.ai/config.json",
43
68
  "mcp": {
44
- "playwright": {
69
+ "uuv": {
45
70
  "type": "local",
46
- "enabled": true,
47
71
  "command": [
48
72
  "npx",
49
73
  "@uuv/mcp-server@latest"
50
- ]
74
+ ],
75
+ "enabled": true
51
76
  }
52
77
  }
53
- ...
54
- ```
78
+ }
79
+
80
+ ```
81
+
82
+
83
+ </details>
84
+
85
+ <summary>Claude Code</summary>
86
+
87
+ Use the Claude Code CLI to add the UUV MCP server:
88
+
89
+ ```bash
90
+ claude mcp add uuv npx @uuv/mcp-server@latest
91
+ ```
92
+ </details>
package/dist/CHANGELOG.md CHANGED
@@ -1,3 +1,10 @@
1
+ ## [0.1.2](https://github.com/e2e-test-quest/uuv/compare/mcp-server-v0.1.1...mcp-server-v0.1.2) (2025-11-20)
2
+
3
+
4
+ ### Bug Fixes
5
+
6
+ * **assistant:** set dom-accessibility-api dependency as runtime dependency ([8f6588e](https://github.com/e2e-test-quest/uuv/commit/8f6588e71bdb5fccee1e4fe8047038853e76e13a))
7
+
1
8
  ## [0.1.1](https://github.com/e2e-test-quest/uuv/compare/mcp-server-v0.1.0...mcp-server-v0.1.1) (2025-11-20)
2
9
 
3
10
 
package/dist/README.md CHANGED
@@ -2,11 +2,16 @@
2
2
 
3
3
  This library is an MCP (Model Context Protocol) server for UUV - a solution to facilitate the writing and execution of E2E tests understandable by any human being(English or French) using cucumber(BDD) and cypress or playwright.
4
4
 
5
+ ## Requirements
6
+ - Node.js 20
7
+ - Opencode, Claude Desktop, Goose or any other MCP client
8
+ - [Playwright MCP Server](https://github.com/microsoft/playwright-mcp)
9
+
5
10
  ## Exposed MCP Tools
6
11
 
7
12
  This MCP server exposes the following tools:
8
13
 
9
- ### 1. retrieve_prompt
14
+ ### retrieve_prompt
10
15
  - **Description**: Retrieve a uuv prompt template for a coding agent based on a prompt name and arguments.
11
16
  - **Input Schema**:
12
17
  - `promptName` (enum): Either "generate_table" or "generate_role_and_name"
@@ -15,40 +20,73 @@ This MCP server exposes the following tools:
15
20
  - `accessibleName` (string, optional): Accessible name
16
21
  - `accessibleRole` (string, optional): Accessible role
17
22
 
18
- ### 2. available_sentences
23
+ ### available_sentences
19
24
  - **Description**: List all available UUV test sentences/phrases in Gherkin format.
20
25
  - **Input Schema**:
21
26
  - `category` (enum, optional): Filters sentences by action type (general, keyboard, click, contains, type, checkable)
22
27
  - `role` (string, optional): Filters sentences related to an accessible role
23
28
 
24
- ### 3. generate_role_and_name
29
+ ### generate_role_and_name
25
30
  - **Description**: Generate a complete UUV test scenario (Gherkin format) to verify the presence of an element with specified accessible name and role.
26
31
  - **Input Schema**:
27
32
  - `baseUrl` (string): The base URL of the page where the element is located
28
33
  - `accessibleName` (string): Accessible name of the element
29
34
  - `accessibleRole` (string): Accessible role of the element
30
35
 
31
- ### 4. generate_table
36
+ ### generate_table
32
37
  - **Description**: Generate a complete UUV test scenario (Gherkin format) to verify the presence and content of html table, grid or treegrid.
33
38
  - **Input Schema**:
34
39
  - `baseUrl` (string): The base URL of the page where the table/grid/treegrid is located
35
40
  - `innerHtmlFilePath` (string): File path containing the raw innerHTML content
36
41
 
37
- ## Command
38
- Add the following command to execute **UUV MCP Server** `npx @uuv/mcp-server`.
42
+ ## Getting started
43
+
44
+ First, install the UUV MCP server with your client.
45
+
46
+ **Standard config** works in most of the tools:
47
+
48
+ ```js
49
+ {
50
+ "mcpServers": {
51
+ "uuv": {
52
+ "command": "npx",
53
+ "args": [
54
+ "@uuv/mcp-server@latest"
55
+ ]
56
+ }
57
+ }
58
+ }
59
+ ```
60
+
61
+ <summary>opencode</summary>
62
+
63
+ Follow the MCP Servers [documentation](https://opencode.ai/docs/mcp-servers/). For example in `~/.config/opencode/opencode.json`:
39
64
 
40
- ### Opencode configuration example (opencode.json)
41
65
  ```json
42
- ...
66
+ {
67
+ "$schema": "https://opencode.ai/config.json",
43
68
  "mcp": {
44
- "playwright": {
69
+ "uuv": {
45
70
  "type": "local",
46
- "enabled": true,
47
71
  "command": [
48
72
  "npx",
49
73
  "@uuv/mcp-server@latest"
50
- ]
74
+ ],
75
+ "enabled": true
51
76
  }
52
77
  }
53
- ...
54
- ```
78
+ }
79
+
80
+ ```
81
+
82
+
83
+ </details>
84
+
85
+ <summary>Claude Code</summary>
86
+
87
+ Use the Claude Code CLI to add the UUV MCP server:
88
+
89
+ ```bash
90
+ claude mcp add uuv npx @uuv/mcp-server@latest
91
+ ```
92
+ </details>
package/dist/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@uuv/mcp-server",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "A Model Context Protocol (MCP) server for UUV - a solution to facilitate the writing and execution of E2E tests understandable by any human being(English or French) using cucumber(BDD) and cypress or playwright.",
5
5
  "author": "Louis Fredice NJAKO MOLOM (https://github.com/luifr10) & Stanley SERVICAL (https://github.com/stanlee974)",
6
6
  "license": "MIT",
@@ -59,8 +59,8 @@
59
59
  "jsdom": "26.1.0",
60
60
  "tsconfig-paths": "4.2.0",
61
61
  "tslib": "2.3.0",
62
- "@uuv/dictionary": "0.1.0",
63
- "@uuv/assistant": "2.73.1",
62
+ "@uuv/dictionary": "0.1.1",
63
+ "@uuv/assistant": "2.73.2",
64
64
  "zod": "3.25.76"
65
65
  },
66
66
  "funding": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@uuv/mcp-server",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
4
  "description": "A Model Context Protocol (MCP) server for UUV - a solution to facilitate the writing and execution of E2E tests understandable by any human being(English or French) using cucumber(BDD) and cypress or playwright.",
5
5
  "author": "Louis Fredice NJAKO MOLOM (https://github.com/luifr10) & Stanley SERVICAL (https://github.com/stanlee974)",
6
6
  "license": "MIT",