MCP ExplorerExplorer

Gomcp

@lightpanda-ioon 10 months ago
14 Apache-2.0
FreeCommunity
AI Systems
Lightpanda MCP server written in Go

Overview

What is Gomcp

gomcp is a Lightpanda MCP server written in Go, designed to facilitate interaction with the Lightpanda Browser via the CDP protocol.

Use cases

Use cases for gomcp include automated testing of web applications, debugging web pages, and integrating with AI tools like Claude Desktop for enhanced functionality.

How to use

To use gomcp, first install the Lightpanda Browser. Then, download the gomcp binary using ‘gomcp download’. You can start a local instance or connect to a remote browser using the ‘–cdp’ option.

Key features

Key features of gomcp include local browser instance management, remote browser connectivity via CDP, and easy configuration for integration with Claude Desktop.

Where to use

gomcp is primarily used in web development and testing environments where interaction with the Lightpanda Browser is required.

Content

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:

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers