browser-mcp-demo
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Host to bind the HTTP server | |
| PORT | No | Port to bind the HTTP server | |
| HEADLESS | No | Whether to run browser headless | |
| VIEW_MODE | No | View mode: info or novnc | |
| UI_DIST_DIR | No | Path to serve built UI from | |
| MAX_SESSIONS | No | Maximum number of concurrent sessions | |
| OPENAI_MODEL | No | OpenAI model name | |
| PROFILES_DIR | No | Directory to store browser profiles | |
| XHS_BASE_URL | No | Base URL for XHS | |
| AUDIT_LOG_PATH | No | Path for audit log file | |
| DELETE_PROFILE | No | Whether to delete profile after session | |
| OPENAI_API_KEY | No | OpenAI API key for agent functionality | |
| PUBLIC_BASE_URL | No | Public base URL for the server | |
| NOVNC_URL_TEMPLATE | No | Template for noVNC URL, supports {sessionId} | |
| SESSION_TTL_MINUTES | No | TTL for browser sessions in minutes | |
| AGENT_RUN_TTL_MINUTES | No | TTL for agent runs in minutes |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_sessionC | Create a new browser session and return sessionId + viewUrl. |
| wait_for_loginC | Poll login status for a session (site-specific when provided). |
| platform_searchC | Search a site and return a list of notes. |
| xhs_open_and_extractC | Open a note and extract full detail (site-specific). |
| destroy_sessionC | Destroy a browser session. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool has a clear and distinct purpose: session creation/destruction, platform searching, login polling, and site-specific extraction. No overlapping functionality.
Naming conventions are inconsistent: create_session and destroy_session follow verb_noun, but platform_search is noun_verb, wait_for_login uses a preposition, and xhs_open_and_extract is a long combined verb. No uniform pattern.
Five tools is an appropriate scope for a demo browser MCP server, covering essential workflows without being overwhelming.
The set covers a specific workflow (session management, search, login, extraction) for a particular site, but lacks generic browser actions like navigation, clicking, or form filling, which limits its applicability to other contexts.