dramaturgo-mcp

Envoltorio de Playwright para MCP (Protocolo de Contexto de Modelo). Este servidor permite a los clientes con tecnología LLM controlar un navegador para tareas de automatización.

Componentes

Recursos

El servidor expone recursos para acceder a las capturas de pantalla del navegador:

URI del recurso de captura de pantalla: screenshot://{page_id}
Los recursos de captura de pantalla están disponibles automáticamente para todas las páginas abiertas

Indicaciones

El servidor proporciona un mensaje para ayudar a los clientes a interpretar las páginas web:

interpret-page : analiza el contenido y la estructura de la página web actual
- Argumento page_id opcional para seleccionar qué página interpretar
- Argumento focus opcional para centrarse en aspectos específicos (completo, formularios, navegación, texto)
- Devuelve tanto el análisis de texto como una captura de pantalla de la página.

Herramientas

El servidor implementa un conjunto completo de herramientas de automatización del navegador:

Navegación del navegador
- navigate : Ir a una URL específica
- new_page : Crea una nueva página del navegador con un ID específico
- switch_page : Cambiar a una página diferente del navegador
- get_pages : Lista todas las páginas del navegador disponibles
Interacción de la página
- click : haga clic en un elemento usando el selector CSS
- type : Escribe texto en un elemento de entrada
- wait_for_selector : Esperar a que aparezca un elemento en la página
Extracción de contenido
- get_text : Obtener el contenido de texto de un elemento
- get_page_content : Obtener el HTML de la página completa
- take_screenshot : Captura el estado visual de la página o elemento

Configuración

Instalar dependencias

uv add playwright
playwright install chromium

Inicio rápido

Instalar

Escritorio de Claude

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

"mcpServers": {
  "playwright-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/shannon/Workspace/artivus/playwright-mcp",
      "run",
      "playwright-mcp"
    ]
  }
}

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

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

Distribuciones de paquetes de compilación:

uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

Publicar en PyPI:

uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores 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 en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /Users/shannon/Workspace/artivus/playwright-mcp run playwright-mcp

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.