Lightpanda Go MCP server

1# Lightpanda Go MCP server
2 
3`gomcp` is an [MCP server](https://modelcontextprotocol.io) written in
4[Go](https://go.dev/).
5 
6It exposes tools to interact with [Lightpanda Browser](https://lightpanda.io/)
7via [CDP protocol](https://chromedevtools.github.io/devtools-protocol/).
8 
9```mermaid
10flowchart LR;
11  A[CDP Client]-->|SSE or stdio|gomcp;
12  gomcp-->|CDP|B[Lightpanda browser];
13```
14 
15## Installation
16 
17### Requirements
18 
19`gomcp` requires you to have already installed [Lightpanda
20Browser](https://lightpanda.io/docs/getting-started/installation).
21 
22### Build from source
23 
24You need to install [Go](https://go.dev/doc/install) to build from source.
25 
26Once you have cloned the repository, build the binary with `go build`.
27 
28## Usage
29 
30By default, `gocmp` starts a local instance of Lightpanda browser.
31 
32On the first run, you need to download the binary with the command:
33```
34$ gomcp download
35```
36The browser is stored in the user config directory.
37`$XDG_CONFIG_HOME/lightpanda-gomcp` or `HOME/.config/lightpanda-gomcp` on
38Linux, `$HOME/Library/Application Support/lightpanda-gomcp` on Macosx.
39 
40You can remove the downloaded binary with `gomcp cleanup` command.
41 
42You can connect on a remote browser with the option `--cdp`.
43```
44$ gomcp -cdp ws://127.0.0.1:9222 stdio
45```
46 
47###  Configure Claude Desktop
48 
49You can configure `gomcp` as a source for your [Claude
50Desktop](https://claude.ai/download).
51 
52Claude Desktop uses the
53[stdio](https://modelcontextprotocol.io/docs/concepts/transports#standard-input%2Foutput-stdio)
54transport to connect to an MCP server.
55 
56Edit the `claude_desktop_config.json` configuration file and add `gomcp` as the mcp
57server **and restart Claude Desktop**.
58 
59```json
60{
61  "mcpServers": {
62    "lightpanda": {
63      "command": "/path/to/gomcp",
64      "args": ["stdio"]
65    }
66  }
67}
68```
69 
70The model context protocol website gives a way to find
71[claude_desktop_config.json](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server)
72file.
73 
74### Standard input/output (stdio)
75 
76You can start `gomcp` as a
77[stdio](https://modelcontextprotocol.io/docs/concepts/transports#standard-input%2Foutput-stdio).
78 
79```
80$ ./gomcp stdio
81```
82 
83### Server-Sent Events (SSE)
84 
85You can start `gomcp` as a
86[SSE](https://modelcontextprotocol.io/docs/concepts/transports#server-sent-events-sse).
87 
88By default, the server listens to the HTTP connection at `127.0.0.1:8081`.
89 
90```
91$ ./gomcp sse
922025/05/06 14:37:13 INFO server listening addr=127.0.0.1:8081
93```
94## Thanks
95 
96`gomcp` is built thanks of open source projects, in particular:
97* [Go language](https://go.dev)
98* [Chromedp](https://github.com/chromedp/chromedp)
99* [JohannesKaufmann/html-to-markdown](github.com/JohannesKaufmann/html-to-markdown)
100* [Lightpanda Browser](https://github.com/lightpanda-io/browser)
101