Rod MCP

🚀 Rod MCP Server

Rod-MCP offers browser automation capabilities based on Rod, providing powerful web interaction abilities for your applications. This server provides many useful tools that enable LLMs (Large Language Models) to interact with web pages, such as clicking elements, capturing screenshots, saving pages as PDFs, etc.

🚀 Quick Start

Rod-MCP Server provides browser automation features based on Rod, enabling seamless interaction between LLMs and web pages.

✨ Features

• 🚀 Rod-based browser automation.
• 🎯 Rich web interaction capabilities:
  • Element clicking.
  • Screenshot capturing.
  • PDF generation.
  • And many more...
• 🎨 Supports headless mode and GUI.
• ⚡ High performance and stability.
• 🔧 Easy to configure and extend.
• 🤖 Specifically designed for LLM 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 Examples

Basic Usage

1. Clone the repository and build it yourself or download from the release page.
2. Configure MCP:

{
    "mcpServers": {
        "rod-mcp": {
            "command": "rod-mcp",
            "args": [
                "-c", "rod-mcp.yaml"
            ]
        }
    }
}

Configuration Options

The configuration file supports the following options:

• serverName: Server name, default is "Rod Server".
• browserBinPath: Path to the browser executable. If empty, the system default browser will be used.
• headless: Whether to run the browser in headless mode, default is false.
• browserTempDir: Temporary file directory for the browser, default is "./rod/browser".
• noSandbox: Whether to disable the sandbox mode, default is false.
• proxy: Proxy server settings, supports socks5 proxy.

📚 Documentation

Project Structure

rod-mcp/
├── assets/          # Static resources
├── banner/          # Banner resources
├── cmd.go           # Command-line handling
├── main.go          # Program entry
├── resources/       # Resource files
├── server.go        # Server implementation
├── tools/           # Tool implementation
├── types/           # Type definitions
└── utils/           # Helper functions

🤝 Contribution

We welcome pull requests and issues!

📄 License

This project is open-sourced under the MIT License. Please refer to the LICENSE file for details.