Lightpanda Go MCP server

Um servidor MCP baseado em Go para interagir com o navegador Lightpanda usando o Chrome DevTools Protocol (CDP).

Documentação

Lightpanda Go MCP server


:warning: Este projeto foi um primeiro experimento para expor um MCP para o Lightpanda Browser. Mas agora, o navegador incorpora um servidor MCP nativamente. Mais detalhes no post do blog sobre MCP nativo.


gomcp é um servidor MCP escrito em Go.

Ele expõe ferramentas para interagir com o Lightpanda Browser via protocolo CDP.

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

Instalação

Requisitos

gomcp requer que você já tenha instalado o Lightpanda Browser.

Compilar a partir do código-fonte

Você precisa instalar o Go para compilar a partir do código-fonte.

Depois de clonar o repositório, compile o binário com go build.

Uso

Por padrão, gocmp inicia uma instância local do navegador Lightpanda.

Na primeira execução, você precisa baixar o binário com o comando:

$ gomcp download

O navegador é armazenado no diretório de configuração do usuário. $XDG_CONFIG_HOME/lightpanda-gomcp ou HOME/.config/lightpanda-gomcp no Linux, $HOME/Library/Application Support/lightpanda-gomcp no Macosx.

Você pode remover o binário baixado com o comando gomcp cleanup.

Você pode conectar a um navegador remoto com a opção --cdp.

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

Configurar o Claude Desktop

Você pode configurar gomcp como uma fonte para o seu Claude Desktop.

O Claude Desktop usa o stdio transporte para conectar a um servidor MCP.

Edite o arquivo de configuração claude_desktop_config.json e adicione gomcp como o servidor mcp e reinicie o Claude Desktop.

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

O site do protocolo de contexto de modelo fornece uma maneira de encontrar o arquivo claude_desktop_config.json.

Entrada/saída padrão (stdio)

Você pode iniciar gomcp como um stdio.

$ ./gomcp stdio

Server-Sent Events (SSE)

Você pode iniciar gomcp como um SSE.

Por padrão, o servidor escuta a conexão HTTP em 127.0.0.1:8081.

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

Agradecimentos

gomcp é construído graças a projetos de código aberto, em particular: