Package Exports

levisnkyyy-browser-use-mcp
levisnkyyy-browser-use-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (levisnkyyy-browser-use-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Browser-Use MCP Server

An MCP (Model Context Protocol) server that provides browser automation capabilities through the Browser-Use API.

Installation

cd mcp
npm install
npm run build

Configuration

The MCP server requires the following environment variables:

BROWSER_USE_API_URL: The URL of the Browser-Use API server (default: http://localhost:8000)
BROWSER_USE_API_KEY: Optional API key for authentication with the Browser-Use API

LLM Provider API Keys

LLM provider API keys (OpenAI, Anthropic, Google) must be configured on the Browser-Use API server side as environment variables:

OPENAI_API_KEY: For OpenAI models (e.g., gpt-4o)
ANTHROPIC_API_KEY: For Anthropic models (e.g., claude-3-5-sonnet)
GOOGLE_API_KEY: For Google models (e.g., gemini-pro)

These keys are not passed through the MCP protocol for security reasons.

Usage

With Claude Desktop

Add the following to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "browser-use": {
      "command": "node",
      "args": ["/path/to/browser-use/mcp/dist/index.js"],
      "env": {
        "BROWSER_USE_API_URL": "http://localhost:8000"
      }
    }
  }
}

With other MCP clients

export BROWSER_USE_API_URL=http://localhost:8000
node dist/index.js

Available Tools

Task Management

browser_use_create_task - Create a new browser automation task
browser_use_get_task - Get task status and results
browser_use_list_tasks - List all tasks
browser_use_cancel_task - Cancel a running task
browser_use_pause_task - Pause a running task
browser_use_get_task_history - Get task execution history
browser_use_get_screenshot - Get current browser screenshot
browser_use_stream_task - Stream real-time task updates

Session Management

browser_use_create_session - Create a reusable browser session
browser_use_close_session - Close a browser session

System

browser_use_health - Check API health status

Examples

Create a task

{
  "task": "Navigate to example.com and take a screenshot",
  "browser_config": {
    "headless": false,
    "viewport": { "width": 1920, "height": 1080 }
  }
}

Create a reusable session

{
  "headless": false,
  "viewport": { "width": 1280, "height": 720 },
  "cookies": [
    {
      "name": "session",
      "value": "abc123",
      "domain": ".example.com"
    }
  ]
}

Development

# Run in development mode with hot reload
npm run dev

# Build for production
npm run build

# Start production server
npm start