返回 MCP 目录
public公开dns本地运行

rod-mcp

Rod-MCP是一个基于Rod的浏览器自动化服务器,为应用程序提供丰富的网页交互能力。

article

README

🚀 Rod MCP 服务器

Rod-MCP 基于 Rod 提供浏览器自动化功能,为应用赋予强大的网页交互能力。借助该服务器,LLM(大语言模型)能够轻松与网页互动,实现点击元素、捕获截图、保存页面为 PDF 等操作。

🚀 快速开始

Rod-MCP 提供基于 Rod 的浏览器自动化功能,让你可以轻松实现网页交互。你可以按照以下步骤快速开始使用:

  1. 完成安装(具体安装步骤见下方“安装指南”)。
  2. 参考“使用方法”进行配置和操作。

✨ 主要特性

  • 🚀 基于 Rod 的浏览器自动化:利用 Rod 的强大功能实现浏览器自动化操作。
  • 🎯 丰富的网页交互能力:
    • 元素点击:精准点击网页上的元素。
    • 截图功能:捕获网页的截图。
    • PDF 生成:将网页保存为 PDF 文件。
    • 以及其他更多功能...
  • 🎨 支持无头模式/图形界面:可根据需求选择运行模式。
  • ⚡ 高性能和稳定性:确保服务的高效稳定运行。
  • 🔧 易于配置和扩展:方便根据实际需求进行定制。
  • 🤖 专为 LLM 交互设计:满足大语言模型与网页的交互需求。

📦 安装指南

先决条件

  • Go 1.23 或更高版本
  • Chrome/Chromium 浏览器

安装步骤

  1. 克隆仓库:
git clone https://github.com/go-rod/rod-mcp.git
cd rod-mcp
  1. 安装依赖项:
go mod tidy
  1. 构建项目:
go build

💻 使用示例

基本用法

  1. 克隆仓库并自行构建或 访问发布页面下载
  2. 配置 MCP:
{
    "mcpServers": {
        "rod-mcp": {
            "command": "rod-mcp",
            "args": [
                "-c", "rod-mcp.yaml"
            ]
        }
    }
}

配置选项

配置文件支持以下选项:

  • serverName: 服务器名称,默认为 "Rod Server"
  • browserBinPath: 浏览器可执行文件路径,为空时使用系统默认浏览器
  • headless: 是否以无头模式运行浏览器,默认为 false
  • browserTempDir: 浏览器临时文件目录,默认为 "./rod/browser"
  • noSandbox: 是否禁用沙盒模式,默认为 false
  • proxy: 代理服务器设置,支持 socks5 代理

🔧 技术细节

项目结构

rod-mcp/
├── assets/          # 静态资源
├── banner/          # Banner 资源
├── cmd.go           # 命令行处理
├── main.go          # 程序入口
├── resources/       # 资源文件
├── server.go        # 服务器实现
├── tools/           # 工具实现
├── types/           # 类型定义
└── utils/           # 辅助函数

🤝 贡献指南

欢迎提交 Pull Request 或创建 Issue,共同为项目的发展贡献力量!

📄 许可证

本项目在 MIT License 下开源,具体请查看 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端