synthux-mcp 0.0.0-stage → 2.1.0
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 +78 -2
- package/dist/cli.js +3086 -0
- package/package.json +44 -4
- package/rules/ecommerce.json +163 -0
- package/rules/fintech.json +163 -0
- package/rules/flow-heuristics.json +58 -0
- package/rules/nielsen-10.json +201 -0
- package/rules/saas.json +163 -0
- package/server.js +1429 -0
package/README.md
CHANGED
|
@@ -1,3 +1,79 @@
|
|
|
1
|
-
#
|
|
1
|
+
# synthux-mcp — Official Model Context Protocol (MCP) Server
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Connect desktop AI coding agents (**Google Antigravity**, **Claude Desktop / Claude Code**, **Cursor**, **OpenAI Codex**, **Windsurf**, or **Local LLM MCP Hosts**) directly to the **synthux** Chrome Extension and UX Audit Engine.
|
|
4
|
+
|
|
5
|
+
## Architecture & Security
|
|
6
|
+
|
|
7
|
+
- **Dual MCP Transport:** Supports both **Stdio** (`npx -y synthux-mcp` / `node mcp/server.js`) and **Streamable HTTP** (`http://127.0.0.1:17483/mcp`).
|
|
8
|
+
- **Live Chrome Extension Bridge:** Connects to the synthux MV3 Chrome Extension over local WebSocket (`ws://127.0.0.1:17483/ws`).
|
|
9
|
+
- **Two AI Evaluation Modes:**
|
|
10
|
+
1. **Agent-Brain Mode (Passthrough):** Your connected MCP Agent (e.g., Antigravity Gemini 4 Argon, Claude, Codex) uses `synthux_prepare_external_audit` to scan the live DOM, run `axe-core` WCAG 2.2 AA checks, and get Sectoral Rule Pack prompts — evaluates them with its own intelligence — and calls `synthux_submit_external_audit` to render live page heatmaps, annotated screenshots, and Enhanced v2.0 Markdown/JSON reports.
|
|
11
|
+
2. **Extension AI Engine Mode:** Trigger `synthux_run_ux_audit` to run the audit using the extension's configured **Local LLM (Ollama: `gemma4`, `qwen3.8`, `deepseek-r1`)** or **Cloud BYOK API (`Gemini`, `OpenAI`, `Claude`)**.
|
|
12
|
+
- **Privacy & Security Hardened:**
|
|
13
|
+
- Strictly bound to `127.0.0.1` loopback (never exposed to LAN/`0.0.0.0`).
|
|
14
|
+
- Strict Origin Verification blocks all `http://` and `https://` web page origins from accessing `/ws` or `/mcp` (CSRF / WebSocket hijacking protection).
|
|
15
|
+
- Optional `SYNTHUX_MCP_TOKEN` pairing token for high-security workstations.
|
|
16
|
+
- Zero telemetry and automatic API key redaction.
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Quick Setup (`mcp_config.json`)
|
|
21
|
+
|
|
22
|
+
### Google Antigravity (`~/.gemini/config/mcp_config.json`) / Claude / Cursor
|
|
23
|
+
|
|
24
|
+
```json
|
|
25
|
+
{
|
|
26
|
+
"mcpServers": {
|
|
27
|
+
"synthux": {
|
|
28
|
+
"command": "node",
|
|
29
|
+
"args": ["/path/to/synthux/mcp/server.js"]
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Or via `npx`:
|
|
36
|
+
|
|
37
|
+
```json
|
|
38
|
+
{
|
|
39
|
+
"mcpServers": {
|
|
40
|
+
"synthux": {
|
|
41
|
+
"command": "npx",
|
|
42
|
+
"args": ["-y", "synthux-mcp"]
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Or via **Streamable HTTP**:
|
|
49
|
+
|
|
50
|
+
```json
|
|
51
|
+
{
|
|
52
|
+
"mcpServers": {
|
|
53
|
+
"synthux": {
|
|
54
|
+
"url": "http://127.0.0.1:17483/mcp"
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## Available MCP Tools (14 Tools)
|
|
63
|
+
|
|
64
|
+
| Tool | Description |
|
|
65
|
+
| :--- | :--- |
|
|
66
|
+
| `synthux_status` | Check MCP bridge, Chrome extension connection, active tab, Rule Packs, Personas, and AI status |
|
|
67
|
+
| `synthux_open_url` | Open or navigate a Chrome tab to a target URL and wait for load completion |
|
|
68
|
+
| `synthux_list_tabs` | List open web tabs in Chrome |
|
|
69
|
+
| `synthux_scan_page` | Extract DOM structure, headings, landmarks, forms, navigation, CTAs, contrast, and performance |
|
|
70
|
+
| `synthux_run_wcag_audit` | Run deterministic DOM accessibility checks + live `axe-core` WCAG 2.2 AA audit |
|
|
71
|
+
| `synthux_run_ux_audit` | Run full autonomous UX audit via Local Ollama or BYOK Cloud API |
|
|
72
|
+
| `synthux_prepare_external_audit` | Prepare DOM + WCAG + Screenshot + Sectoral Rule Pack prompts for external MCP Agent evaluation |
|
|
73
|
+
| `synthux_submit_external_audit` | Submit external MCP Agent evaluations to render live Heatmap, Annotated Screenshot, and v2.0 Report |
|
|
74
|
+
| `synthux_run_flow_audit` | Run multi-page Flow Builder user journey evaluation across 2+ URLs |
|
|
75
|
+
| `synthux_visual_overlay` | Trigger live `highlight`, `heatmap`, `clear_all`, `annotated_screenshot`, or `full_screenshot` |
|
|
76
|
+
| `synthux_manage_rule_packs` | List, inspect, import/validate custom JSON rule packs, or delete custom rule packs |
|
|
77
|
+
| `synthux_manage_personas` | List, create custom synthetic user personas, or delete custom personas |
|
|
78
|
+
| `synthux_configure_ai` | Configure Local Ollama or Cloud AI provider settings and test connectivity |
|
|
79
|
+
| `synthux_get_reports` | List report history or export reports in Enhanced Markdown v2.0 or JSON format |
|