claude-computer-use-mcp by Theopsguide - MCP Server

🤖 Claude Computer Use MCP Server

🚀 Transform Claude into a powerful browser automation tool!

An MCP (Model Context Protocol) server that gives Claude the ability to control web browsers, take screenshots, navigate websites, and perform automated web tasks - all through natural conversation.

🎯 What Can You Do?

Ask Claude to:

📸 "Take a screenshot of google.com"
🔍 "Navigate to reddit.com and extract the top headlines"
🛒 "Go to amazon.com and search for laptops"
📊 "Compare pricing across 3 e-commerce sites"
🧪 "Test if our website loads correctly"
🎨 "Browse design portfolios for inspiration"

⚡ Quick Install

Option 1: NPM (Recommended)

# Install globally
npm install -g claude-computer-use-mcp

# Install browser dependencies
npx playwright install chromium

# Add to Claude Desktop (see setup guide below)

Option 2: From Source

git clone https://github.com/Theopsguide/claude-computer-use-mcp.git
cd claude-computer-use-mcp
npm install && npm run build

🛠️ Setup Guide

Step 1: Install Dependencies

# Install browser binaries
npx playwright install chromium

# Linux/WSL: Install system dependencies
sudo apt-get update
sudo apt-get install -y libnspr4 libnss3 libatk-bridge2.0-0 libdrm2 libgtk-3-0 libgbm1

Step 2: Configure Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "claude-computer-use": {
      "command": "npx",
      "args": ["claude-computer-use-mcp"]
    }
  }
}

Windows with WSL: Use this configuration instead:

{
  "mcpServers": {
    "claude-computer-use": {
      "command": "wsl",
      "args": ["node", "/home/username/claude-computer-use-mcp/dist/index.js"]
    }
  }
}

Step 3: Configure Claude Code (Optional)

# Global installation
claude mcp add computer-use "npx" "claude-computer-use-mcp"

# From source
claude mcp add computer-use "node" "/path/to/claude-computer-use-mcp/dist/index.js"

🚀 Quick Start

Restart Claude Desktop and try these commands:

"Launch a browser and take a screenshot of google.com"
"Navigate to github.com and extract all the repository links"  
"Go to reddit.com and tell me the top 3 headlines"
"Take screenshots of apple.com, microsoft.com, and google.com"
"Browse to hacker news and summarize the trending topics"

🎉 That's it! Claude can now control browsers through natural conversation.

🔧 Browser Automation Tools

Tool	Description	Example Usage
`browser_launch`	Launch browser instances	"Launch a browser"
`browser_navigate`	Navigate to URLs	"Go to github.com"
`browser_screenshot`	Capture screenshots	"Take a screenshot"
`browser_click`	Click elements	"Click the search button"
`browser_type`	Type text into inputs	"Type 'Claude AI' in the search box"
`browser_select`	Select dropdown options	"Select 'English' from language dropdown"
`browser_wait`	Wait for elements	"Wait for the page to load"
`browser_execute`	Execute JavaScript	"Get page metrics"
`browser_get_text`	Extract text content	"Get all the headlines"
`browser_get_attribute`	Get element attributes	"Get all image URLs"
`browser_get_url`	Get current URL	"What page am I on?"
`browser_get_title`	Get page title	"What's the page title?"
`browser_list_sessions`	List active sessions	"Show my browser sessions"
`browser_close`	Close browser sessions	"Close the browser"

📚 Documentation

Document	Description
	50+ real-world use cases and examples
	Complete API reference and tool specifications
	Code examples and automation patterns
	Comprehensive installation guide
	Security features and best practices

🛡️ Security Features

✅ Input Validation - All inputs sanitized and validated
✅ URL Restrictions - Only HTTP/HTTPS allowed, blocks internal IPs
✅ Session Management - Secure session IDs with automatic cleanup
✅ Resource Limits - Max 10 concurrent sessions, 30-minute timeout
✅ JavaScript Disabled - By default for security (can be enabled)

🤝 Contributing

We welcome contributions! Please see for guidelines.

Quick Development Setup

git clone https://github.com/Theopsguide/claude-computer-use-mcp.git
cd claude-computer-use-mcp
npm install
npm run dev  # Watch mode for development

🐛 Troubleshooting

Browser won't launch?

Install Playwright: npx playwright install chromium
Install system deps: sudo npx playwright install-deps chromium

MCP server not connecting?

Restart Claude Desktop completely
Check configuration in Claude settings
Verify the server path is correct

Windows + WSL issues?

Use the WSL configuration shown in setup guide
Ensure dependencies are installed in WSL

More help: Check our

📊 Requirements

Node.js 18+
Claude Desktop or Claude Code CLI
Operating System: Windows (with WSL), macOS, or Linux
Browser: Chromium (auto-installed via Playwright)

⭐ Show Your Support

If this project helps you, please give it a ⭐ on GitHub!

Built with ❤️ by Luke Thompson