Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,21 @@ All notable changes to MCP Selenium will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.0.1] - 2025-06-12

### Added
- Added Windows installer (`install.bat`)
- Fixed path handling in bash script for Windows
- Proper JSON escaping for Windows paths
- Updated documentation with platform-specific instructions

## [1.0.0] - 2025-06-11

### Added

**Core MCP Server**

- Full MCP 2024-11-05 protocol implementation
- Full MCP protocol implementation
- JSON-RPC communication over stdin/stdout
- Comprehensive tool discovery and validation
- Graceful error handling and recovery
Expand Down
49 changes: 18 additions & 31 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,10 @@
# MCP Selenium - The Industry Standard

[![Maven Central](https://img.shields.io/maven-central/v/io.github.abarrac/mcp-selenium.svg)](https://search.maven.org/artifact/io.github.abarrac/mcp-selenium)
[![Build Status](https://github.com/abarrac/mcp-selenium/workflows/CI/badge.svg)](https://github.com/abarrac/mcp-selenium/actions)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Java](https://img.shields.io/badge/Java-11%2B-orange.svg)](https://openjdk.java.net/)

> The professional-grade Selenium WebDriver MCP server for AI agents and automation tools, trusted by developers worldwide.
> The professional-grade Selenium WebDriver MCP server for AI agents and automation tools.

MCP Selenium provides a comprehensive Model Context Protocol (MCP) implementation for browser automation, making it effortless for **any AI agent or automation tool** to interact with web applications. Built with enterprise-grade reliability and performance in mind.

Expand All @@ -14,7 +13,7 @@ MCP Selenium provides a comprehensive Model Context Protocol (MCP) implementatio
Before installing MCP Selenium, ensure you have:

- **Java 11+**
- **Chrome Browser** - [Download here](https://www.google.com/chrome/) (recommended)
- **Chrome Browser** - [Download here](https://www.google.com/chrome/)
- **Claude Desktop** - [Download here](https://claude.ai/download) (for Claude integration)

### Quick Check
Expand All @@ -32,9 +31,11 @@ google-chrome --version # Linux
## πŸš€ Quick Start

### For Claude Desktop Users
1. **Install & Configure:** `curl -sSL https://raw.githubusercontent.com/abarrac/mcp-selenium/main/install.sh | bash`
1. **Install & Configure:**
- **Windows**: `powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/abarrac/mcp-selenium/main/install.bat' -OutFile 'install.bat'; .\install.bat"`
- **macOS/Linux**: `curl -sSL https://raw.githubusercontent.com/abarrac/mcp-selenium/main/install.sh | bash`
2. **Restart:** Claude Desktop
3. **Test:** Ask Claude to "take a screenshot of google.com"
3. **Test:** Ask Claude to "using selenium MCP tools, navigate to google.com and take a screenshot"

For detailed installation options, see [Configuration](#-configuration).

Expand Down Expand Up @@ -123,27 +124,34 @@ MCP Selenium Core
Choose one of these installation methods:

**Option A: Quick Install (Recommended)**

**Windows:**
```powershell
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/abarrac/mcp-selenium/main/install.bat' -OutFile 'install.bat'; .\install.bat"
```

**macOS/Linux:**
```bash
curl -sSL https://raw.githubusercontent.com/abarrac/mcp-selenium/main/install.sh | bash
```
*This script automatically handles Step 2 configuration. Skip to Step 3 after installation.*
*These scripts automatically handle Step 2 configuration. Skip to Step 3 after installation.*

**Option B: Manual Download**
```bash
# Download the latest release
wget https://github.com/abarrac/mcp-selenium/releases/latest/download/mcp-selenium-1.0.0.jar
wget https://github.com/abarrac/mcp-selenium/releases/latest/download/mcp-selenium-1.0.1.jar

# Move to a permanent location
mkdir -p ~/.mcp-selenium
mv mcp-selenium-1.0.0.jar ~/.mcp-selenium/mcp-selenium.jar
mv mcp-selenium-1.0.1.jar ~/.mcp-selenium/mcp-selenium.jar
```

**Option C: Build from Source**
```bash
git clone https://github.com/abarrac/mcp-selenium.git
cd mcp-selenium
mvn clean package
cp target/mcp-selenium-1.0.0.jar ~/.mcp-selenium/mcp-selenium.jar
cp target/mcp-selenium-1.0.1.jar ~/.mcp-selenium/mcp-selenium.jar
```

#### Step 2: Configure Claude Desktop (Manual Installation Only)
Expand Down Expand Up @@ -172,7 +180,7 @@ Restart Claude Desktop for the changes to take effect.
#### Step 4: Verify Installation
Open Claude Desktop and try asking:
```
"Take a screenshot of google.com"
"Take a screenshot of google.com using selenium MCP tools"
```

If you see browser automation happening, you're all set! πŸŽ‰
Expand Down Expand Up @@ -227,27 +235,6 @@ MCP Selenium supports all major selector strategies:
| Class | `class=value` | `class=btn-primary` |
| Tag | `tag=value` | `tag=button` |

## 🚒 Installation Options

### Option 1: Quick Install Script
```bash
curl -sSL https://raw.githubusercontent.com/abarrac/mcp-selenium/main/install.sh | bash
```

### Option 2: Maven/Gradle
```xml
<dependency>
<groupId>io.github.abarrac</groupId>
<artifactId>mcp-selenium</artifactId>
<version>1.0.0</version>
</dependency>
```

### Option 3: GitHub Releases
```bash
wget https://github.com/abarrac/mcp-selenium/releases/latest/download/mcp-selenium-1.0.0.jar
```

## πŸ“‹ Requirements

- **Java**: 11 or higher
Expand Down
49 changes: 18 additions & 31 deletions README_es.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,10 @@
# MCP Selenium - El EstΓ‘ndar de la Industria

[![Maven Central](https://img.shields.io/maven-central/v/io.github.abarrac/mcp-selenium.svg)](https://search.maven.org/artifact/io.github.abarrac/mcp-selenium)
[![Build Status](https://github.com/abarrac/mcp-selenium/workflows/CI/badge.svg)](https://github.com/abarrac/mcp-selenium/actions)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Java](https://img.shields.io/badge/Java-11%2B-orange.svg)](https://openjdk.java.net/)

> El servidor MCP de Selenium WebDriver de nivel profesional para agentes de IA y herramientas de automatizaciΓ³n, en el que confΓ­an desarrolladores de todo el mundo.
> El servidor MCP de Selenium WebDriver de nivel profesional para agentes de IA y herramientas de automatizaciΓ³n.

MCP Selenium proporciona una implementaciΓ³n completa del Protocolo de Contexto de Modelo (MCP) para automatizaciΓ³n de navegadores, haciendo que sea muy fΓ‘cil para **cualquier agente de IA o herramienta de automatizaciΓ³n** interactuar con aplicaciones web. Construido pensando en la fiabilidad y el rendimiento de nivel empresarial.

Expand All @@ -14,7 +13,7 @@ MCP Selenium proporciona una implementaciΓ³n completa del Protocolo de Contexto
Antes de instalar MCP Selenium, asegΓΊrate de tener:

- **Java 11+**
- **Navegador Chrome** - [Descargar aquΓ­](https://www.google.com/chrome/) (recomendado)
- **Navegador Chrome** - [Descargar aquΓ­](https://www.google.com/chrome/)
- **Claude Desktop** - [Descargar aquΓ­](https://claude.ai/download) (para integraciΓ³n con Claude)

### VerificaciΓ³n RΓ‘pida
Expand All @@ -32,9 +31,11 @@ google-chrome --version # Linux
## πŸš€ Inicio RΓ‘pido

### Para Usuarios de Claude Desktop
1. **Instalar y Configurar:** `curl -sSL https://raw.githubusercontent.com/abarrac/mcp-selenium/main/install.sh | bash`
1. **Instalar y Configurar:**
- **Windows**: `powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/abarrac/mcp-selenium/main/install.bat' -OutFile 'install.bat'; .\install.bat"`
- **macOS/Linux**: `curl -sSL https://raw.githubusercontent.com/abarrac/mcp-selenium/main/install.sh | bash`
2. **Reiniciar:** Claude Desktop
3. **Probar:** Pregunta a Claude "toma una captura de pantalla de google.com"
3. **Probar:** Pregunta a Claude "utilizando las herramientas de selenium MCP, navega a google.com y toma una captura de pantalla"

Para opciones de instalaciΓ³n detalladas, consulta [ConfiguraciΓ³n](#-configuraciΓ³n).

Expand Down Expand Up @@ -123,27 +124,34 @@ MCP Selenium Core
Elige uno de estos mΓ©todos de instalaciΓ³n:

**OpciΓ³n A: InstalaciΓ³n RΓ‘pida (Recomendada)**

**Windows:**
```powershell
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/abarrac/mcp-selenium/main/install.bat' -OutFile 'install.bat'; .\install.bat"
```

**macOS/Linux:**
```bash
curl -sSL https://raw.githubusercontent.com/abarrac/mcp-selenium/main/install.sh | bash
```
*Este script maneja automΓ‘ticamente la configuraciΓ³n del Paso 2. Salta al Paso 3 despuΓ©s de la instalaciΓ³n.*
*Estos scripts manejan automΓ‘ticamente la configuraciΓ³n del Paso 2. Salta al Paso 3 despuΓ©s de la instalaciΓ³n.*

**OpciΓ³n B: Descarga Manual**
```bash
# Descargar la ΓΊltima versiΓ³n
wget https://github.com/abarrac/mcp-selenium/releases/latest/download/mcp-selenium-1.0.0.jar
wget https://github.com/abarrac/mcp-selenium/releases/latest/download/mcp-selenium-1.0.1.jar

# Mover a una ubicaciΓ³n permanente
mkdir -p ~/.mcp-selenium
mv mcp-selenium-1.0.0.jar ~/.mcp-selenium/mcp-selenium.jar
mv mcp-selenium-1.0.1.jar ~/.mcp-selenium/mcp-selenium.jar
```

**OpciΓ³n C: Compilar desde el CΓ³digo Fuente**
```bash
git clone https://github.com/abarrac/mcp-selenium.git
cd mcp-selenium
mvn clean package
cp target/mcp-selenium-1.0.0.jar ~/.mcp-selenium/mcp-selenium.jar
cp target/mcp-selenium-1.0.1.jar ~/.mcp-selenium/mcp-selenium.jar
```

#### Paso 2: Configurar Claude Desktop (Solo InstalaciΓ³n Manual)
Expand Down Expand Up @@ -174,7 +182,7 @@ Reinicia Claude Desktop para que los cambios surtan efecto.
#### Paso 4: Verificar la InstalaciΓ³n
Abre Claude Desktop y prueba preguntando:
```
"Toma una captura de pantalla de google.com"
"Toma una captura de pantalla de google.com utilizando las herramientas de selenium MCP"
```

Β‘Si ves que la automatizaciΓ³n del navegador estΓ‘ funcionando, ya estΓ‘ todo listo! πŸŽ‰
Expand Down Expand Up @@ -229,27 +237,6 @@ MCP Selenium soporta todas las estrategias principales de selectores:
| Class | `class=value` | `class=btn-primary` |
| Tag | `tag=value` | `tag=button` |

## 🚒 Opciones de Instalación

### OpciΓ³n 1: Script de InstalaciΓ³n RΓ‘pida
```bash
curl -sSL https://raw.githubusercontent.com/abarrac/mcp-selenium/main/install.sh | bash
```

### OpciΓ³n 2: Maven/Gradle
```xml
<dependency>
<groupId>io.github.abarrac</groupId>
<artifactId>mcp-selenium</artifactId>
<version>1.0.0</version>
</dependency>
```

### OpciΓ³n 3: Releases de GitHub
```bash
wget https://github.com/abarrac/mcp-selenium/releases/latest/download/mcp-selenium-1.0.0.jar
```

## πŸ“‹ Requisitos

- **Java**: 11 o superior
Expand Down
87 changes: 87 additions & 0 deletions install.bat
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
@echo off
setlocal enabledelayedexpansion

echo Installing MCP Selenium for Windows...
echo.

REM Check if Java is installed
java -version >nul 2>&1
if errorlevel 1 (
echo ERROR: Java is not installed or not in PATH
echo Please install Java 11+
echo.
pause
exit /b 1
)

echo Java found
echo.

REM Create installation directory
set INSTALL_DIR=%USERPROFILE%\.mcp-selenium
if not exist "%INSTALL_DIR%" mkdir "%INSTALL_DIR%"

echo Downloading MCP Selenium...

REM Download using PowerShell (built into Windows)
powershell -Command "try { Invoke-WebRequest -Uri 'https://github.com/abarrac/mcp-selenium/releases/latest/download/mcp-selenium-1.0.1.jar' -OutFile '%INSTALL_DIR%\mcp-selenium.jar' -UseBasicParsing; Write-Host 'Download completed' } catch { Write-Host 'Download failed'; exit 1 }"

if not exist "%INSTALL_DIR%\mcp-selenium.jar" (
echo ERROR: Failed to download MCP Selenium JAR
pause
exit /b 1
)

echo Download successful
echo.

REM Claude Desktop config path for Windows
set CONFIG_DIR=%APPDATA%\Claude
set CONFIG_FILE=%CONFIG_DIR%\claude_desktop_config.json

echo Config location: %CONFIG_FILE%
echo.

REM Create Claude config directory if it doesn't exist
if not exist "%CONFIG_DIR%" mkdir "%CONFIG_DIR%"

REM Prepare JAR path with escaped backslashes for JSON
set JAR_PATH=%INSTALL_DIR%\mcp-selenium.jar
set JAR_PATH_JSON=!JAR_PATH:\=\\!

REM Check if config file exists
if exist "%CONFIG_FILE%" (
echo WARNING: Claude Desktop config already exists.
echo Please manually add MCP Selenium to: %CONFIG_FILE%
echo.
echo Add this configuration to the mcpServers section:
echo "selenium": {
echo "command": "java",
echo "args": ["-jar", "!JAR_PATH_JSON!"]
echo }
echo.
) else (
echo Creating Claude Desktop config...
(
echo {
echo "mcpServers": {
echo "selenium": {
echo "command": "java",
echo "args": ["-jar", "!JAR_PATH_JSON!"]
echo }
echo }
echo }
) > "%CONFIG_FILE%"
echo Config created successfully
echo.
)

echo Installation completed!
echo.
echo Next steps:
echo 1. Restart Claude Desktop
echo 2. Test with: 'Using selenium MCP tools, navigate to google.com and take a screenshot'
echo.
echo For support, visit: https://github.com/abarrac/mcp-selenium
echo.
pause
Loading