gomcp

README

Lightpanda Go MCP server

gomcp is an MCP server written in Go.

It exposes tools to interact with Lightpanda Browser via CDP protocol.

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

Installation

Requirements

gomcp requires you to have already installed Lightpanda Browser.

Build from source

You need to install Go to build from source.

Once you have cloned the repository, build the binary with go build.

Usage

By default, gocmp starts a local instance of Lightpanda browser.

On the first run, you need to download the binary with the command:

$ gomcp download

The browser is stored in the user config directory. $XDG_CONFIG_HOME/lightpanda-gomcp or HOME/.config/lightpanda-gomcp on Linux, $HOME/Library/Application Support/lightpanda-gomcp on Macosx.

You can remove the downloaded binary with gomcp cleanup command.

You can connect on a remote browser with the option --cdp.

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

Configure Claude Desktop

You can configure gomcp as a source for your Claude Desktop.

Claude Desktop uses the stdio transport to connect to an MCP server.

Edit the claude_desktop_config.json configuration file and add gomcp as the mcp server and restart Claude Desktop.

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

The model context protocol website gives a way to find claude_desktop_config.json file.

Standard input/output (stdio)

You can start gomcp as a stdio.

$ ./gomcp stdio

Server-Sent Events (SSE)

You can start gomcp as a SSE.

By default, the server listens to the HTTP connection at 127.0.0.1:8081.

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

Thanks

gomcp is built thanks of open source projects, in particular:

• Go language
• Chromedp
• JohannesKaufmann/html-to-markdown
• Lightpanda Browser