AI-Driven Chrome Automation Testing Portal
- Edit .env with your configuration
- npm install
- cd client && npm install && cd ..
- npm run dev (development) or npm start (production)
Access at: http://localhost:3001
Set the following environment variables in your .env file to control how the portal connects to running browser sessions:
| Variable | Description | Default |
|---|---|---|
XPRA_BASE_URL |
Base URL for embedded Xpra sessions. | http://10.160.13.110 |
MCP_HOST |
Hostname or IP for the MCP SSE servers (used for /sse connections). |
10.160.13.110 |
MCP_PROTOCOL_VERSION |
Protocol version string sent during MCP initialize. |
0.1.0 |
MCP_DEFAULT_TOOL |
Fallback tool name used when sending plain-text instructions. | execute |
MCP_RESPONSE_TIMEOUT |
Timeout (ms) before an MCP request is considered failed. | 15000 |
MCP_CLIENT_NAME |
Custom client name to advertise via MCP initialize. |
mcp-portal |
MCP_CLIENT_VERSION |
Custom client version to advertise via MCP initialize. |
1.0.0 |
INACTIVE_TIMEOUT |
Timeout (in milliseconds) used for idle session tracking. | 300000 |
OPENAI_API_KEY |
Token used to authenticate requests to your OpenAI/vLLM compatible endpoint. | required for vLLM planning |
OPENAI_BASE_URL |
Base URL for the OpenAI-compatible API served by vLLM. | required for vLLM planning |
OPENAI_MODEL |
Model identifier to request from the OpenAI/vLLM service. | gpt-4o-mini |
If the configured XPRA_BASE_URL is missing or points to localhost, the server will automatically reuse the hostname from the incoming request so that remote users don't get stuck with localhost iframe URLs. This makes the portal usable behind port forwarding or tunnelling setups without requiring additional configuration.
When the OpenAI/vLLM variables are configured the portal will call the model to produce a short plan for each instruction, which is surfaced directly in the session console. Configuration values are managed entirely through environment variables—the in-app configuration panel has been removed to avoid exposing sensitive details.