Playwright Server

playwright-server MCP server

\Un servidor MCP con herramientas de playwright\

Componentes

Recursos

El servidor implementa un sistema simple de almacenamiento de notas con:

• Esquema URI personalizado note:// para acceder a notas individuales
• Cada recurso de nota tiene un nombre, descripción y tipo MIME text/plain

Prompts

El servidor proporciona un único prompt:

• summarize-notes: Crea resúmenes de todas las notas almacenadas
  • Argumento opcional "style" para controlar el nivel de detalle (breve/detallado)
  • Genera un prompt que combina todas las notas actuales con la preferencia de estilo

Herramientas

El servidor implementa las siguientes herramientas:

• playwright_navigate: Navega a una URL especificada. Esta operación creará automáticamente una nueva sesión si no hay una sesión activa.
  • Requiere un argumento url (cadena).
• playwright_screenshot: Toma una captura de pantalla de la página actual o de un elemento específico.
  • Requiere un argumento name (cadena) para el nombre del archivo de captura.
  • Argumento opcional selector (cadena) para especificar un selector CSS del elemento a capturar. Si no se proporciona un selector, se toma una captura de página completa.
• playwright_click: Hace clic en un elemento de la página usando un selector CSS.
  • Requiere un argumento selector (cadena) para especificar el selector CSS del elemento en el que hacer clic.
• playwright_fill: Rellena un campo de entrada.
  • Requiere un argumento selector (cadena) para especificar el selector CSS del campo de entrada.
  • Requiere un argumento value (cadena) para especificar el valor a rellenar.
• playwright_evaluate: Ejecuta código JavaScript en la consola del navegador.
  • Requiere un argumento script (cadena) para especificar el código JavaScript a ejecutar.
• playwright_click_text: Hace clic en un elemento de la página por su contenido de texto.
  • Requiere un argumento text (cadena) para especificar el contenido de texto del elemento en el que hacer clic.
• playwright_get_text_content: Obtiene el contenido de texto de todos los elementos visibles.
• playwright_get_html_content: Obtiene el contenido HTML de la página.
  • Requiere un argumento selector (cadena) para especificar el selector CSS del elemento.

Configuración

[TODO: Añade detalles de configuración específicos de tu implementación]

Inicio rápido

Instalación

Claude Desktop

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuración de Servidores de Desarrollo/No Publicados

``` "mcpServers": { "playwright-server": { "command": "uv", "args": [ "--directory", "C:\Users\xxxxx\Documents\project\python\mcp\playwright-server", "run", "playwright-server" ] } } ```

Configuración de Servidores Publicados

``` "mcpServers": { "playwright-server": { "command": "uvx", "args": [ "playwright-server" ] } } ```

Desarrollo

Compilación y Publicación

Para preparar el paquete para su distribución:

1. Sincroniza las dependencias y actualiza el archivo de bloqueo:

uv sync

2. Compila las distribuciones del paquete:

uv build

Esto creará distribuciones de código fuente y wheel en el directorio dist/.

3. Publica en PyPI:

uv publish

Nota: Necesitarás configurar las credenciales de PyPI mediante variables de entorno o banderas de comando:

• Token: --token o UV_PUBLISH_TOKEN
• O nombre de usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan sobre stdio, la depuración puede ser un desafío. Para la mejor experiencia de depuración, recomendamos encarecidamente usar el MCP Inspector.

Puedes iniciar el MCP Inspector mediante npm con este comando:

npx @modelcontextprotocol/inspector uv --directory C:\Users\YUNYING\Documents\project\python\mcp\playwright-server run playwright-server

Al iniciarlo, el Inspector mostrará una URL a la que podrás acceder en tu navegador para comenzar a depurar.