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