Rod MCP

🚀 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

2. 安装依赖项:

go mod tidy

3. 构建项目:

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 文件。