https://github.com/go-rod/rod-mcp

Model Context Protocol Server of Rod
https://github.com/go-rod/rod-mcp

browser-automation go-rod golang llm llvm mcp mcp-server mcp-tools rod

Last synced: 6 months ago
JSON representation

Model Context Protocol Server of Rod

• Host: GitHub
• URL: https://github.com/go-rod/rod-mcp
• Owner: go-rod
• Created: 2025-03-25T13:23:16.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-04-12T10:15:14.000Z (6 months ago)
• Last Synced: 2025-04-12T11:27:34.189Z (6 months ago)
• Topics: browser-automation, go-rod, golang, llm, llvm, mcp, mcp-server, mcp-tools, rod
• Language: Go
• Homepage:
• Size: 1.9 MB
• Stars: 12
• Watchers: 0
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Rod MCP Server





Wow! It's awesome, now you can use the MCP server of Rod!🚀




Rod-MCP provides browser automation capabilities for your applications by using [Rod](https://github.com/go-rod/rod). The server provides many useful mcp tools enable LLMs to interact with the web pages, like click, take screenshot, save page as pdf etc.



Engilsh |  中文 



## Features

- 🚀 Browser automation powered by Rod

- 🎯 Rich web interaction capabilities

  - Element clicking

  - Screenshot capture

  - PDF generation

  - And more...

- 🎨 Headless/GUI mode support

- ⚡ High performance and stability

- 🔧 Easy to configure and extend

- 🤖 Designed for LLMs interaction

## Installation

### Prerequisites

- Go 1.23 or higher

- Chrome/Chromium browser

### Steps

1. Clone the repository:

```bash

git clone https://github.com/go-rod/rod-mcp.git

cd rod-mcp

```

2. Install dependencies:

```bash

go mod tidy

```

3. Build the project:

```bash

go build

```

## Usage

### Basic Usage

1. Clone Repo and Build Self or [Go to Download Release](https://github.com/go-rod/rod-mcp/releases)

2. Configure MCP:

```json

{

    "mcpServers": {

        "rod-mcp": {

            "command": "rod-mcp",

            "args": [

                "-c", "rod-mcp.yaml"

            ]

        }

    }

}

```

### Configuration

The configuration file supports the following options:

- serverName: Server name, default is "Rod Server"

- browserBinPath: Browser executable file path, use system default browser if empty

- headless: Whether to run the browser in headless mode, default is false

- browserTempDir: Browser temporary file directory, default is "./rod/browser"

- noSandbox: Whether to disable sandbox mode, default is false

- proxy: Proxy server settings, supports socks5 proxy

## Project Structure

```

rod-mcp/

├── assets/          # Static resources

├── banner/          # Banner resources

├── cmd.go           # Command line processing

├── main.go          # Program entry

├── resources/       # Resource files

├── server.go        # Server implementation

├── tools/           # Tool implementation

├── types/           # Type definitions

└── utils/           # Utility functions

```

## Contribution Guidelines

Welcome to submit Pull Request or create Issue!

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file