Servidor de navegador web MCP

Un servidor de navegación web avanzado para el Protocolo de Contexto de Modelo (MCP) impulsado por Playwright, que permite interacciones de navegador sin cabeza a través de una API flexible y segura.

🌐 Características

Navegación web sin interfaz gráfica : navegue a cualquier sitio web sin necesidad de validar el certificado SSL.
Extracción de contenido de página completa : recupera contenido HTML completo, incluido JavaScript cargado dinámicamente
Compatibilidad con múltiples pestañas : cree, administre y cambie entre múltiples pestañas del navegador
Herramientas avanzadas de interacción web :
- Extraer contenido de texto
- Haga clic en los elementos de la página
- Introducir texto en los campos de formulario
- Capturar capturas de pantalla
- Extraer enlaces de páginas con capacidades de filtrado
- Desplácese por las páginas en cualquier dirección
- Ejecutar JavaScript en las páginas
- Actualizar páginas
- Espere a que se complete la navegación
Gestión de recursos : Limpieza automática de recursos no utilizados después de la inactividad
Información de página mejorada : obtenga metadatos detallados sobre la página actual

🚀 Inicio rápido

Prerrequisitos

Python 3.10+
Kit de desarrollo de software de MCP
Dramaturgo

Instalación

# Install MCP and Playwright
pip install mcp playwright

# Install browser dependencies
playwright install

Configuración para Claude Desktop

Añade a tu claude_desktop_config.json :

{
  "mcpServers": {
    "web-browser": {
      "command": "python",
      "args": [
        "/path/to/your/server.py"
      ]
    }
  }
}

💡 Ejemplos de uso

Navegación web básica

# Browse to a website
page_content = browse_to("https://example.com")

# Extract page text
text_content = extract_text_content()

# Extract text from a specific element
title_text = extract_text_content("h1.title")

Interacción web

# Navigate to a page
browse_to("https://example.com/login")

# Input text into a form
input_text("#username", "your_username")
input_text("#password", "your_password")

# Click a login button
click_element("#login-button")

Captura de pantalla

# Capture full page screenshot
full_page_screenshot = get_page_screenshots(full_page=True)

# Capture specific element screenshot
element_screenshot = get_page_screenshots(selector="#main-content")

Extracción de enlaces

# Get all links on the page
page_links = get_page_links()

# Get links matching a pattern
filtered_links = get_page_links(filter_pattern="contact")

Navegación con múltiples pestañas

# Create a new tab
tab_id = create_new_tab("https://example.com")

# Create another tab
another_tab_id = create_new_tab("https://example.org")

# List all open tabs
tabs = list_tabs()

# Switch between tabs
switch_tab(tab_id)

# Close a tab
close_tab(another_tab_id)

Interacciones avanzadas

# Scroll the page
scroll_page(direction="down", amount="page")

# Execute JavaScript on the page
result = execute_javascript("return document.title")

# Get detailed page information
page_info = get_page_info()

# Refresh the current page
refresh_page()

# Wait for navigation to complete
wait_for_navigation(timeout_ms=5000)

🛡️ Funciones de seguridad

Omisión de la validación del certificado SSL
Gestión segura del contexto del navegador
Configuración personalizada del agente de usuario
Manejo de errores y registro completo
Configuraciones de tiempo de espera configurables
Control de derivación de CSP
Protección contra el robo de cookies

🔧 Solución de problemas

Problemas comunes

Errores del certificado SSL : se omiten automáticamente
Carga de página lenta : ajuste el tiempo de espera en el método browse_to()
Elemento no encontrado : Verifique los selectores cuidadosamente
Uso de recursos del navegador : limpieza automática después de un período de inactividad

Explotación florestal

Todos los eventos importantes se registran con información detallada para una fácil depuración.

📋 Parámetros de la herramienta

`browse_to(url: str, context: Optional[Any] = None)`

url : Sitio web al que navegar
context : objeto de contexto opcional (actualmente sin uso)

`extract_text_content(selector: Optional[str] = None, context: Optional[Any] = None)`

selector : Selector CSS opcional para extraer contenido específico
context : objeto de contexto opcional (actualmente sin uso)

`click_element(selector: str, context: Optional[Any] = None)`

selector : selector CSS del elemento en el que hacer clic
context : objeto de contexto opcional (actualmente sin uso)

`get_page_screenshots(full_page: bool = False, selector: Optional[str] = None, context: Optional[Any] = None)`

full_page : Capturar una captura de pantalla de toda la página
selector : Elemento opcional para captura de pantalla
context : objeto de contexto opcional (actualmente sin uso)

`get_page_links(filter_pattern: Optional[str] = None, context: Optional[Any] = None)`

filter_pattern : Patrón de texto opcional para filtrar enlaces
context : objeto de contexto opcional (actualmente sin uso)

`input_text(selector: str, text: str, context: Optional[Any] = None)`

selector : selector CSS del elemento de entrada
text : Texto a introducir
context : objeto de contexto opcional (actualmente sin uso)

`create_new_tab(url: Optional[str] = None, context: Optional[Any] = None)`

url : URL opcional para navegar en la nueva pestaña
context : objeto de contexto opcional (actualmente sin uso)

`switch_tab(tab_id: str, context: Optional[Any] = None)`

tab_id : ID de la pestaña a la que cambiar
context : objeto de contexto opcional (actualmente sin uso)

`list_tabs(context: Optional[Any] = None)`

context : objeto de contexto opcional (actualmente sin uso)

`close_tab(tab_id: Optional[str] = None, context: Optional[Any] = None)`

tab_id : ID opcional de la pestaña que se cerrará (predeterminado: la pestaña actual)
context : objeto de contexto opcional (actualmente sin uso)

`refresh_page(context: Optional[Any] = None)`

context : objeto de contexto opcional (actualmente sin uso)

`get_page_info(context: Optional[Any] = None)`

context : objeto de contexto opcional (actualmente sin uso)

`scroll_page(direction: str = "down", amount: str = "page", context: Optional[Any] = None)`

direction : Dirección para desplazarse ('arriba', 'abajo', 'izquierda', 'derecha')
amount : Cantidad a desplazar ('página', 'mitad' o un número)
context : objeto de contexto opcional (actualmente sin uso)

`wait_for_navigation(timeout_ms: int = 10000, context: Optional[Any] = None)`

timeout_ms : Tiempo máximo de espera en milisegundos
context : objeto de contexto opcional (actualmente sin uso)

`execute_javascript(script: str, context: Optional[Any] = None)`

script : código JavaScript para ejecutar
context : objeto de contexto opcional (actualmente sin uso)

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Configuración de desarrollo

# Clone the repository
git clone https://github.com/random-robbie/mcp-web-browser.git

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows use `venv\Scripts\activate`

# Install dependencies
pip install -e .[dev]

📄 Licencia

Licencia MIT

🔗 Proyectos relacionados

💬 Soporte

Si tiene problemas o preguntas, abra un problema en GitHub.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Un servidor de navegación web avanzado que permite interacciones de navegador sin cabeza a través de una API segura, proporcionando funciones como navegación, extracción de contenido, interacción con elementos y captura de capturas de pantalla.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Browser Use Server
JovaniPink
A
security
F
license
A
quality
Enables AI agents to interact with web browsers using natural language, featuring automated browsing, form filling, vision-based element detection, and structured JSON responses for systematic browser control.
Last updated -
1
50
Python
Deepseek R1 MCP Server
grapheneaffiliate
-
security
A
license
-
quality
Enables browser automation and real-time computer vision tasks through AI-driven commands, offering zero-cost digital navigation and interaction for enhanced web experiences.
Last updated -
0
1
JavaScript
MIT License
Fetch Browser
TheSethRose
A
security
A
license
A
quality
A headless browser MCP server that allows AI agents to fetch web content and perform Google searches without API keys, supporting various output formats like Markdown, JSON, HTML, and text.
Last updated -
2
13
TypeScript
MIT License
MCP Headless Gmail Server
baryhuang
A
security
A
license
A
quality
A headless server that enables reading and sending Gmail emails through API calls without requiring local credentials or browser access, designed to run remotely in containerized environments.
Last updated -
4
6
49
Python
MIT License

View all related MCP servers