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: