What is Rod Mcp

Rod-MCP is a Model Context Protocol Server designed to provide browser automation capabilities for applications using the Rod framework. It allows LLMs to interact with web pages through various tools.

Use cases

Use cases for Rod-MCP include automating repetitive web tasks, generating reports from web data, testing web applications, and enabling LLMs to perform actions on web pages like clicking buttons or filling forms.

How to use

To use Rod-MCP, clone the repository, install dependencies, and build the project. Configure the MCP server in a JSON format specifying the server name, browser path, and other settings, then run the server with the specified configuration.

Key features

Key features of Rod-MCP include browser automation powered by Rod, rich web interaction capabilities (clicking elements, capturing screenshots, generating PDFs), support for headless and GUI modes, high performance and stability, easy configuration and extension, and design tailored for LLMs interaction.

Where to use

Rod-MCP can be used in various fields such as web scraping, automated testing, data collection, and enhancing applications that require interaction with web content.

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. 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:

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