@shiplightai/mcp 0.1.13 → 0.1.14
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.
- package/README.md +76 -0
- package/dist/index.js +231 -231
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# @shiplightai/mcp
|
|
2
|
+
|
|
3
|
+
MCP server for AI-powered web application testing. Gives AI coding agents (Claude Code, Cursor, Windsurf, etc.) the ability to control a browser, verify UI flows, and generate rerunnable YAML test files.
|
|
4
|
+
|
|
5
|
+
## Quick Start
|
|
6
|
+
|
|
7
|
+
### Claude Code
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
claude mcp add shiplight -- npx -y @shiplightai/mcp@latest
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
### Cursor / Windsurf / Other MCP Clients
|
|
14
|
+
|
|
15
|
+
Add to your MCP config (e.g., `.cursor/mcp.json`):
|
|
16
|
+
|
|
17
|
+
```json
|
|
18
|
+
{
|
|
19
|
+
"mcpServers": {
|
|
20
|
+
"shiplight": {
|
|
21
|
+
"command": "npx",
|
|
22
|
+
"args": ["-y", "@shiplightai/mcp@latest"]
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
### Environment Variables
|
|
29
|
+
|
|
30
|
+
| Variable | Required | Description |
|
|
31
|
+
|---|---|---|
|
|
32
|
+
| `ANTHROPIC_API_KEY` | One AI key required | Anthropic API key (for Claude models) |
|
|
33
|
+
| `GOOGLE_API_KEY` | One AI key required | Google AI API key (for Gemini models) |
|
|
34
|
+
| `API_TOKEN` | No | Shiplight cloud API token (enables cloud features) |
|
|
35
|
+
|
|
36
|
+
At least one AI API key is needed for the test execution agent. The model is auto-detected from the key (`ANTHROPIC_API_KEY` → `claude-haiku-4-5`, `GOOGLE_API_KEY` → `gemini-2.5-pro`).
|
|
37
|
+
|
|
38
|
+
Pass environment variables through your MCP config:
|
|
39
|
+
|
|
40
|
+
```json
|
|
41
|
+
{
|
|
42
|
+
"mcpServers": {
|
|
43
|
+
"shiplight": {
|
|
44
|
+
"command": "npx",
|
|
45
|
+
"args": ["-y", "@shiplightai/mcp@latest"],
|
|
46
|
+
"env": {
|
|
47
|
+
"ANTHROPIC_API_KEY": "sk-ant-..."
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## What It Does
|
|
55
|
+
|
|
56
|
+
Once connected, your AI coding agent can:
|
|
57
|
+
|
|
58
|
+
- **Browse and interact** — Open pages, click elements, fill forms, navigate
|
|
59
|
+
- **Verify UI** — Assert visual conditions using AI ("Verify the success message is displayed")
|
|
60
|
+
- **Generate local tests** — Scaffold a Playwright project and write `.test.yaml` files with captured action entities for fast, deterministic replay
|
|
61
|
+
- **Manage cloud test cases** — Create, run, and review test cases on Shiplight's cloud platform (requires `API_TOKEN`)
|
|
62
|
+
|
|
63
|
+
## Resources
|
|
64
|
+
|
|
65
|
+
The server exposes schema resources that agents read automatically:
|
|
66
|
+
|
|
67
|
+
| Resource | Description |
|
|
68
|
+
|---|---|
|
|
69
|
+
| `shiplight://schemas/action-entity` | Browser action parameters — read automatically when a session starts |
|
|
70
|
+
| `shiplight://schemas/testflow-yaml-v1.2.0` | YAML test file format — read when creating local tests |
|
|
71
|
+
| `shiplight://schemas/testflow-json-v1.2.0` | JSON test flow format for cloud API (cloud mode only) |
|
|
72
|
+
|
|
73
|
+
## Links
|
|
74
|
+
|
|
75
|
+
- [Shiplight](https://shiplight.ai)
|
|
76
|
+
- [shiplightai npm package](https://www.npmjs.com/package/shiplightai) — Playwright plugin for running `.test.yaml` files locally
|