This MCP client is a modern React-based interface that connects to MCP servers using Server-Sent Events (SSE). It provides a real-time channel to send requests, receive streaming results, and view contextual data such as live screenshots and message history. Use it to connect to any MCP server endpoint, send tasks, cancel in-progress requests, and review the threaded chat-style responses. The UI includes a responsive layout, theme support (light/dark/system), and a live preview featuring browser screenshots generated from server responses. You can initiate a connection, configure the target MCP server URL, and interact with the tools exposed by your chosen MCP server via the SSE stream.

Prerequisites:

• Node.js v18 or newer
• pnpm (recommended)
• A running MCP server to connect to

1. Clone the repository git clone <repository-url> cd browser-use-mcp-client

2. Install dependencies pnpm install

3. Run the development server pnpm dev

4. Open the app The application will be available at http://localhost:5173

Optional: If you need to run a local proxy or supporting server as shown in the README, you can start it with:

Start the proxy/server example (if applicable)

./proxy/index.js

Replace any placeholder paths (like path/to/server.js) with the actual entry points for your local setup.

Notes and tips:

• The client relies on SSE for real-time updates; ensure the MCP server supports SSE and allows cross-origin requests if hosted separately.
• If you’re using an authentication token, configure it via environment variables (e.g., VITE_API_BASE_URL and REACT_APP_MCP_TOKEN).
• The app includes a screenshot preview feature; ensure your MCP server provides or supports screenshot data in the response logs.
• For quickest testing, run a local example MCP server (as shown in the README's Python example) and point the client to its SSE endpoint.
• If you encounter CORS issues, enable appropriate CORS headers on the MCP server or proxy requests through a development server with CORS configured.
• If you update dependencies, reinstall with pnpm install to ensure compatibility with the React stack.