Lightpanda Go MCP server

Un servidor MCP basado en Go para interactuar con el navegador Lightpanda mediante el Protocolo de Chrome DevTools (CDP).

Documentación

Servidor MCP de Lightpanda Go


:warning: Este proyecto fue un primer experimento para exponer un MCP para Lightpanda Browser. Pero ahora, el navegador incorpora un servidor MCP de forma nativa. Más detalles en la publicación del blog sobre el MCP nativo.


gomcp es un servidor MCP escrito en Go.

Expone herramientas para interactuar con Lightpanda Browser a través del protocolo CDP.

flowchart LR;
  A[CDP Client]-->|SSE or stdio|gomcp;
  gomcp-->|CDP|B[Lightpanda browser];

Instalación

Requisitos

gomcp requiere que ya tengas instalado Lightpanda Browser.

Compilar desde el código fuente

Necesitas instalar Go para compilar desde el código fuente.

Una vez que hayas clonado el repositorio, compila el binario con go build.

Uso

Por defecto, gocmp inicia una instancia local del navegador Lightpanda.

En la primera ejecución, necesitas descargar el binario con el comando:

$ gomcp download

El navegador se almacena en el directorio de configuración del usuario. $XDG_CONFIG_HOME/lightpanda-gomcp o HOME/.config/lightpanda-gomcp en Linux, $HOME/Library/Application Support/lightpanda-gomcp en Macosx.

Puedes eliminar el binario descargado con el comando gomcp cleanup.

Puedes conectarte a un navegador remoto con la opción --cdp.

$ gomcp -cdp ws://127.0.0.1:9222 stdio

Configurar Claude Desktop

Puedes configurar gomcp como una fuente para tu Claude Desktop.

Claude Desktop utiliza el transporte stdio para conectarse a un servidor MCP.

Edita el archivo de configuración claude_desktop_config.json y agrega gomcp como el servidor mcp y reinicia Claude Desktop.

{
  "mcpServers": {
    "lightpanda": {
      "command": "/path/to/gomcp",
      "args": ["stdio"]
    }
  }
}

El sitio web del protocolo de contexto de modelos ofrece una forma de encontrar el archivo claude_desktop_config.json.

Entrada/Salida estándar (stdio)

Puedes iniciar gomcp como un stdio.

$ ./gomcp stdio

Eventos enviados por el servidor (SSE)

Puedes iniciar gomcp como un SSE.

Por defecto, el servidor escucha la conexión HTTP en 127.0.0.1:8081.

$ ./gomcp sse
2025/05/06 14:37:13 INFO server listening addr=127.0.0.1:8081

Agradecimientos

gomcp está construido gracias a proyectos de código abierto, en particular: