Rod MCP Server

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:

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

2. Install dependencies:

go mod tidy

3. Build the project:

go build

Usage

Basic Usage

1. Clone Repo and Build Self or Go to Download Release
2. Configure MCP:

{
    "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 file